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PREFACE 


This manual describes and illustrates the features provided by the 
XVM Utility program PIP. This utility program operates only within 
the XVM Disk Operating System (XVM/DOS) monitor environment. 

In the preparation of this manual it was assumed that the reader is 
familiar with the contents of the XVM/DOS USERS MANUAL and with the 
general operating procedures for the XVM equipment. 





CHAPTER 1 
INTRODUCTION 


1.1 PIP PROGRAM 

The PIP XVM (PIP) Utility Program enables the system user to perform 
the following major functions via keyboard commands: 

a) Interchange information between system peripheral I/O 
devices, the system disk device and peripheral I/O devices; 
and between user file areas located on the system disk 
device . 

b) Perform verification and modification procedures on infor- 
mation being transferred. 

c) Initialize, list and modify file directories of directoried 
disk and other directoried devices. 

This manual is primarily concerned with disk-oriented operations. 

PIP, however, may be used with all other standard XVM I/O and mass 
storage devices; limitations and differences in operation are indi- 
cated where applicable. There are specific operations on magtape 
which PIP does not perform, such as create and list a file directory. 
Users of magtape should also read the MTDUMP XVM Utility Manual to 
learn how to perform these special functions using the MTDUMP XVM 
Utility Program. 

1.2 MANUAL ORGANIZATION AND USE 


This manual is intended for users who are familiar with: 


a) the general system operating procedures (i.e. , use of 
equipment and system startup procedures) ; 

b) the elements, structure, and use of the XVM/DOS monitor 
as described in the XVM/DOS Users Manual 

Introductory information and detailed descriptions of PIP operations 
and their applications are given in Chapters 1 through 5. Chapter 6 
contains quick-reference tables. 
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Introduction 


New users of PIP should familiarize themselves with the contents of 
Chapters 1 through 5; thereafter, they need only refer to Chapter 6 
for concise information. 

XVM/DOS terms used in this manual, their acronyms and descriptions, 
are presented in Appendix C. 

1.3 WRITING CONVENTIONS 

Table 1-1 lists a group of commonly used keyboard command and control 
characters together with (a) their functions as recognized by PIP 
and (b) their representations in listing and, in this manual, in 
text and examples. 

1.4 PIP STARTUP PROCEDURES 

Once a user has completed the system log-in procedures, PIP may be 
called into core by the entry of the name "PIP". When loaded, PIP 
outputs the following message on the console printer: 

$PIP 

PIP XVM Vxxnnn 
> 

followed by a right angle ( > ) "ready" symbol. 

User commands are entered immediately after the ready symbol. Once 
an operation has been initiated, the user must not attempt to make 
any further entries until PIP prints the ready symbol. The only 
exception to this is when the user wishes to abort the current opera- 
tion. The entry of: 

a) CTRL P (+P) aborts the current operation and 
returns control to PIP; 

b) CTRL C (+ C) aborts the current operation and 
returns control to the monitor. 


1-2 



Introduction 


ACTUATED 
KEY OR KEY 
COMBINATION 

RUBOUT 

CTRL U 

CTRL P 

CTRL C 

CTRL R 

CTRL D 

SHIFT 0 
or 

UNDER BAR 
RETURN 

ALT MODE 


Table 1-1 

General Keyboard Command Characters 


PRINTED 
RESPONSE & 
TEXT SYMBOLS 


\ 


Response - @ 
Text - lu 

IP 


tc 

+ R 


tD 


or 


Non-printing 
(Text symbol is ) ) 


Non-printing 
(Text symbol is ($) ) 


FUNCTION INITIATED BY ENTRY 


Causes deletion of the last 
entered character. 

Causes deletion of the last 
entered line. 

Restarts PIP or continues on 
interrupted input or output 
operations on a non-directoried 
device 

Causes control to be returned 
to the Monitor . 

Enables processing to be resumed 
when a Device Not Ready (I0PS4) 
error has been corrected. 

Terminates input from the con- 
sole keyboard. 

Divides PIP command string into 
Output and Input sections (see 
Section 2) . 

Initiates a carriage return/ 
line feed operation. Normally 
used to terminate command strings. 

Causes control to be returned 
to the Monitor on completion of 
the current operation. The moni- 
tor performs a carriage return/ 
line feed operation and announces 
itself . 


1-3 





CHAPTER 2 

COMMAND STRING FORMATS AND BASIC OPERATIONS 


This Chapter describes the basic PIP command string formats and the 
elements which comprise them. Included are lists and descriptions of 
the operations provided the user by PIP. 

2.1 PIP COMMAND STRING, GENERAL DESCRIPTION 


PIP command strings are limited to a maximum of 72 characters and a 
single console device input line and no provision is made for com- 
mand string continuation lines. The items which may be specified 
in a PIP command string are: 


Item 


How Specified 


1) Primary operation to Identified by an assigned single alpha- 

be performed betic character (e.g., T for Transfer). 

Refer to Table 2-3 for a description 
of each Primary Operation and its com- 
mand character. 


2) Any storage or I/O Identified by an assigned 2 or 3- 

device(s) involved character alphanumeric mnemonic (e.g., 

DT for DECtape) . Refer to Table 2-2 
for a listing of the standard DOS sys- 
tem storage devices and the mnemonic 
assigned to each. 


3) The names of any 
files involved 


Identified by an assigned (user or 
system) 6-character filename plus a 
3-character extension. Refer to the 
XVM/DOS User's Manual for descriptions 
of filenaming considerations. 


4) Optional Functions 

(i.e.. Data Modes and/or 
secondary operations) 
to be included 


Identified by an assigned alphabetic 
character enclosed in parentheses 
e.g., (A). Refer to Table 2-4 for 

a description of each optional function 
and its assigned command character. 

One or more functions may be specified 
e.g. , (A) or (AN) . 
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Item 


How Specified 


5) Optionally defined 
Protection codes 


6) Required User File 
Directory (UFD) 
Identification 


Identified by a numeric normally en- 
closed in parentheses; only one code 
may be specified in a command. If an 
optional function is specified, the 
protection code and command character (s) 
should be placed within the same set 
of parentheses (e.g., (1) or (Al) ) . 

Refer to paragraph 2.3.7 for a descrip- 
tion of protection codes. 

UFD 1 s in commands are identified by 
their assigned 3-character mnemonic 
(UIC) enclosed within angle brackets 
(e.g., < ABC > ); refer to paragraph 
2.3.5 for a detailed description. 


2.2 TYPES OF PIP COMMANDS 


There are two basic types of PIP commands: 

a) Destination/Source commands, and 

b) Single-Device commands. 

These command categories are described, individually, in paragraphs 
2.2.1 and 2.2.2. 

2.2.1 Destination/Source Commands 

Commands of this type are used to specify PIP operations which in- 
volve the transfer of data between two devices or device areas. 

Such commands consist of two sections separated by a ■*- delimiter: 

[destination] -<-[source] 


The elements within these sections specify where the data to be trans- 
ferred is to be found [SOURCE] and where it is to go [DESTINATION ] . 

The major operation to be performed is always the first character in 
any PIP command string; optional operations may be specified in 
either section of this type of command. For example, in the follow- 
ing command string: 

> T,__ I DK la _ | DESTFL i _ J SRC-(-DTl u _,FILEA L _,SRCy) 
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the destination section consists of: 


[t i _ 1 dk i _ 1 destfl i _ j src] . 


The elements of this section specify: 


a) T = a Transfer operation is to be performed 

b) DK = the disk device is to receive the Transferred 

data 


NOTE 

When disk is specified, it 
represents the current UFD. 


c) DESTFL^jSRC = the name of the disk file into which the 

Transferred data is to be written. 


The SOURCE section of the above command string consists of: 


[ DT 1 ljF I LE A,_,S RC ] 


The elements of this section specify: 

a) DTI = the data to be transferred resides on the tape 

mounted on DECtape Unit #1 

b) FILEA SRC = the name of the DTI file which contains 

the data to be transferred. 

Figure 2-1 illustrates the format of the most complex form of the 
destination/source type of command string. This figure also lists 

a) the PIP operations which require the format illustrated, 

b) permitted device mnemonics, 

c) permitted switch options. 

2.2.2 Single-Device Commands 

Commands of this type are used to specify PIP operations which in- 
volve only a single device and a file or set of files. Such a com 
mand must specify the operation to be performed and the device in- 
volved. Where needed, filenames and option switches may also be 
added to the command string. For example, the command: 

>D 1 __,DTl l _ l FILEA l _jS RCy 
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specifies that: 

a) a delete CD) operation is to be performed, 

b) the device containing the item to be deleted is 
DECtape Unit #1 (DTI) , 

c) the item to be deleted is file FILEA SRC. 


OPERATION 

COMMAND 


DK 


DESTINATION 


DEST=L i 


SRC 


,(G) 


DESTINATION FILE 



OPTION . 
I SWITCH'S! 


DTn 


.SOURCE 
DEVICE I 


DATA 


SOURCE 
(filename | 


SRC } 


FILE 
J ext) 


DTn--- DECtape unit 
TT = Teletype- 
LP = Lino printer 

DK DECdisk 

VP = VP 15 A CRT display 
DPn= is knack uni t 


TERMINATOR 


Vse commas to 
separate mul- 
tiple file 
names and ex- 
tensions . 


PR - Parer tape reader 
TT = Teletype 
CI> •• Card reader 
DTr.= DECtape unit 
MTn= Magtape unit 
DK *= DECdisk 
DPn- - Di s k p a ck ur. i t 
RKn~ Disk cartridge unit 


Returr. 
control 
to PIP 
ALTMODE = 
Return 
control 
to the 
monitor 



a « POPS ASCII 
B = IOPS Binary 
I = Image Alpha - 
numeri c 
Image Binary 
Dump 


H 


Convert tabs to spaces 
Flag bad parity lines 
Convert multiple spaces to 
tabs 

Combine files 
So ament files 
New Directory 

= New directory with CTRL Q 
area. Size of area (nn) = 

8, 12, 16, 20, 24, 28, or 32 
(K words) N- operation only. 
Default = current size of 
system. 

Insert Form Feed every 
linos or after .EJECT 
Delete trailing spaces 


55 


10 


Delete sequence numbers 
Request a listing of 
the system. MFD 
Request a listing of the 
system SYSBLK directory 
Request CFD listing with 
RIB data 

Vertical Control 


} 


Input must be 
in punched 
card format 


Figure 2-1 

Destination/Source Command String 


Format 
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Figure 2-2 illustrates the format of the most complex form of a Single- 
Device PIP command. Also listed in Figure 2-2 are: 

a) the operations which require the illustrated format, 

b) permitted device mnemonics, 

c) permitted switch options. 


DTn 


FI LEA/FI LEB 


(A) j 


OPERATION 

COMMAND 

CHARACTER 


DEVICE 

MNEMONIC! 


N = New directory 
V = Verify file 
D = Delete 
I = Initialize 
U = Update 


FILE(s) INVOLVED 
Filename .i | Ext. 


OPTION 

switch(es) 


TERMINATOR 


Use commas to separate 
multiple filenames and 
extensions . 


PR = Paper Tape Reader 
DTn = DECtape unit 
DK = DECdisk 
DPn = Diskpack unit 
MTn = Magtape unit 
RKn = Disk cartridge unit 


J 


=Return 
to PIP 


control 


ALT MODE = 
Return control 
to Monitor 


A = IOPS ASCII Data mode 
B = IOPS Binary Data mode 
S = New directory with a 
core-sized 1QAREA. 

Snn = New directory with a 

user -specif ied +QAREA. 
K = delete UFD . 

X = delete all truncated 
files . 


Figure 2-2 

PIP Single Device Commands, General Format 


1 


DECtape 


only 
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2 . 3 COMMAND STRING ELEMENTS 

The basic elements which comprise the PIP command strings (i.e., de- 
limiters, mnemonics, format requirements, etc.) are described in the 
following paragraphs. Also described are the major user capabilities 
offered by PIP, sub-functions which may be carried out within the 
context of major PIP operations, and how UFD's, data modes and pro- 
tection codes are specified in PIP commands. 


2.3.1 Command String Delimiters 


Delimiters are flags which are set to separate elements of a command 
string. The delimiters used in PIP commands are listed and their 
uses described in the following table. 

Table 2-1 

Command String Delimiters 


Use Delimiter: 

To 

In This Manner: 

1 1 

(space) 

Separate major command string 
elements 

TuDK^FILE. . . 

«- 

(back 

arrow) 

(underbar) 

Separate destination and 
source sections of a command 
string 

dest. -- source 

T 1 _jDK«-DTl,_ 1 FILEA 1 _jSRC 


(colon) 

a) In RENAME command, sepa- 
rates UFD name from speci- 
fied UFD protection code 

< JAN : $ > 



b) Separate device mnemonic 
and filename 

DTI :FILEA 

r 

(comma) 

a) Separate filenames within 
a command string list 

DTl^FILEA , FILEB , FILEC 



b) Specify number of tapes 
or files involved in an 
operation when names are 
not needed 

PR. .. , (READ 3 tapes) 

; 

(semi- 

colon) 

Separate filename and file- 
name extension or data mode 
option 

DTI : FILEA , FILEB ; SRC 

< > 

(angle 
brackets ) 

Identify non-current UFD's 

< JOE> 

( 

) (paren- 
theses) 

Identify option switches or 
specified protection codes 

(A) 

- 

(dash) 

Separator to indicate a 
range of numbers 

100-150 
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2.3.2 Standard XVM/DOS I/O and Storage Devices 

The I/O and storage devices for which the XVM/DOS Monitor contains 
interfacing software are listed, together with their required command 
mnemonics, in the following table. 

Table 2-2 

PIP Command Device Mnemonics 


Peripheral Device 


Required Mnemonic 


DECdisk (RF15) DK 

Diskpack (RP^2) DPn 

Disk cartridge (RK05) RKn 

DECtape DTn 

Magnetic tape MTn 

Teletype TT 

Line Printer LP 

Card Reader CD 

Paper Tape Reader PR 

Paper Tape Punch PP 

Graphics Display VT 

XY11/XY311 Plotters XY 

Printer/Plotter LV 


NOTE 

The letter n in the above table indicates 
"unit number". For example, DECtape unit 
#1 of a system is specified as DTI. If no 
unit number is specified in the mnemonic 
for a multi-unit device, the numeric 0 is 
assumed. For example, the mnemonic DP is 
equivalent to UP0 . 


2.3.3 Primary Operations 


The major capabilities provided by PIP are referred to as primary 
operations. Transfer, the user-directed interchange of files between 
storage devices, and List, the printing of user-specified user and 
monitor directories, are two examples of PIP primary operations. 

In a PIP command, the primary operation is identified by a single 
alphabetic letter entered as the first character of the command 
string. For example, in the command: 

>Tt_jDK DTluFILEAujSRCy 


the letter "T" specifies the transfer operation (i.e., FILEA SRC 
is to be transferred from DTI to the current UFD on DK) . 
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All PIP primary operations are listed and described briefly in 
Table 2-3. 


Table 2-3 

PIP Primary Operations, Summary 


The Primary is identified 

by the 


and performs the 


OPERATION COMMAND CHARACTER 


FUNCTION 


TRANSFER T 

VERIFY V 

SEGMENT S 

LIST L 

NEW DIRECTORY N 

DELETE D 

RENAME R 

COPY, Mass Storage C 

BLOCK COPY B 


INITIALIZE I 


UPDATE U 


Transfer named data files between 
peripheral I/O devices. 

Check a named file for parity or 
checksum errors. 

Divide a file into a specified 
number of segments (16 maximum) and 
store each segment as a separate 
named file. 

Provide listings of system direc- 
tories . 

Either clear an existing directory 
or, if one does not exist, estab- 
lish a new one. 

Delete files from User File Direc- 
tories . 

Rename files and change protection 
codes for the file or the UFD in 
which it is listed. 

Copy the contents of one mass 
storage medium onto another. 

Copy the contents of one or more 
selected data storage blocks con- 
tained by one device onto another 
medium. Block copy to the disk may 
be performed only by the MIC user. 

Enable the system manager to clear 
all disk bit maps and restore the 
MFD to its original state. This 
command may be used only by the 
MIC user. 

Update the monitor ' s Bad Allocation 
Table (BAT) and Storage Allocation 
Table (SAT) whenever defective stor 
age blocks are detected on the disk 


2-8 



Command String Formats and Basic Operations 


2.3.4 Optional Functions 

PIP primary operations may be executed alone or they may include 
one or more "optional functions". 

The optional functions are used to specify parameters (such as data 
modes) and secondary operations (such as parity checks) which are to be 
carried out during the execution of the primary operations. An optiona 
function is identified by an alphabetic letter enclosed in parentheses 
which is entered as a switch in a PIP command. Switch (A) which spec- 
ifies that I OPS ASCII data is to be handled in the performance of the 
primary operation and switch (Y) which indicates that a file segmen- 
tation operation is to be performed during the primary operation are 
two examples of optional functions and their switches. The use of 
switch (A) in the following command: 

>T,_,DK+- DTli_,FILEAi_i(A) J 

specifies that the data contained by FILEA is in IOPS ASCII form. 

All PIP optional functions are listed and described in Table 2-4. 

Table 2-4 

PIP Optional Functions 


OPTION 

COMMAND 

CHARACTER 

IOPS ASCII 

Data Mode 

(A) 

IOPS Binary 

(B) 

Image Alphanumeric (I) 

Dump 

(D) 

Image Binary 

(H) 

Bad Parity & 
Checksum Check 
& Correction 

(G) 

Tab to Space 
Conversion 

(E) 

Convert Multiple 
Spaces to Tabs 

(C) 


FUNCTION 


Specifies the type of data (i.e., 
format) handled by the primary 
PIP operation. 


Outputs error messages and the 
lines containing errors detected. 
Corrective actions are permitted. 

Causes all tabs found in the data 
handled to be expanded into a 
series of spaces. 

Causes each group of two or more 
spaces encountered during the pri- 
mary operation to be contracted to 
a TAB. 
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Table 2-4 (Cont) 

PIP Optional Functions 

COMMAND 

OPTION CHARACTER FUNCTION 


Segment Files 

m 

Indicates that the file being trans- 
ferred is to be segmented. 

Combine Files 

(W) 

Combines two or more separate files 
into a single file. 

Form Feed 

(F) 

Causes a form-feed and a RETURN char- 
acter to be inserted after the detec- 
tion of each .EJECT statement or after 
every 55 ^q lines. 

Delete Trailing 

(T) 

Causes all trailing spaces to be de- 
leted from alphanumeric data being 
handled during the primary operation. 

Delete Sequence 
Numbers 

(Q) 

Used for punched card input, this 
option causes all input sequence num- 
bers to be deleted. 

Reserve QAREA with 
New Directory 

(Snn) 

Used for DECtape devices only, this 
option initializes any existing direc- 
tory or establishes a new directory, 
and causes a CTRL Q area to be allo- 
cated on the device. The size of 
the allocated area may be specified 
(i.e., nn) by the user. 

New Directory 

(N) 

Performs the same function as the N 
primary operation. It either clears 
an existing directory or, if one 
does not exist, establishes a new one. 

List MFD 

(M) 

Enables standard UIC users to obtain 
a listing of all unprotected UFD's 
contained by the device (disk) . The 
MIC user will obtain a listing of all 
UFD's contained by the device. 

List SYSBLK 

(L) 

Enables the user to obtain a listing 
of the system SYSBLK directory. 

List UFD with 
Auxiliary Data 

(P) 

Causes file RIB data to be added to a 
UFD listing. 

Delete UFD 

(K) 

Removes UFD entry from MFD. 

Delete All 
Truncated 

Files 

(X) 

Causes all truncated files contained 
by the current or specified UFD to 
be deleted. 

Vertical Forms 
Control 

(V) 

Translates standard FORTRAN IV verti- 
cal form control characters to those 
that can be interpreted by the line 
printer handler. 

File Protection 
Codes 

(N) 

Specifies a protection code if a code 
other than the default is desired for 


the output files. 
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2.3.5 Specifying UFD's 

Whenever a user logs in to the XVM/DOS Monitor prior to calling PIP, 
he specifies a user identification code, e.g., 

$ LOGIN RPK 

This code (in this example, RPK) is taken to be the name of the UFD 
(User File Directory) used in operation to and from disk whenever a 
UFD is not specified in a command. It is called the default or cur- 
rent UFD. 

Whenever a UFD which is not current is referenced in a PIP command 
string : 

a) its UIC (identifying code) written within angle 
bracket delimiters (e.g., <xxx>) must be added 
to the command. 

b) the UIC must be inserted immediately after the 
mnemonic representing the device on which its 
UFD resides. 

For example, the command: 

> Tu_i DK^j < JAN >f-DT 1 i_jF ILE A^jS RC J 

specifies that FILEA SRC on DECtape unit #1 is to be transferred to 
the non-current UFD "JAN" located on the disk device. 

2.3.6 Specifying Data Modes 1 

PIP operations which involve the interchange of data require that the 
form of the data being handled (i.e., its data mode) be indicated in 
the initiating command string. 

Data modes in PIP are specified either by the filename extension of 
the file being transferred or by an equivalent data mode option 
switch. The Data Mode indicators recognized by PIP are listed in 
the following table (Table 2-5) . 

The available PIP data mode switches and their uses are: 

a. (A) IOPS ASCII Switch - Files containing data in 
IOPS ASCII form require the use of the PIP (A) 
data mode switch. ASCII files are identified by 
the extensions: 1) SRC or 

2) a 3-character extension where the 
third character is numeric (e.g., 

004) . 

b. (B) IOPS Binary Switch - Files containing data in IOPS 
Binary form must be handled using the (B) switch. The 
filename extension BIN is used to identify binary files. 


1 Refer to the XVM/DOS Users Manual for detailed descriptions of data 
modes. 
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c. (I) Image Alphanumeric Switch - The (I) switch is re- 
quired during transfer of Image Alphanumeric files 
and, as the name Image implies, maintains the File data 
m its exact form as read from the source file. The (I) 
switch must specifically be used when copies of paper 
tapes in either HRM or RIM hardware reader modes (MACRO 
.ABS or .FULL paper tape) are required. 

d. (H) Image Binary Switch - Binary files (extension BIN) 
to be maintained in their exact form must be transferred 
using the (H) data mode switch. 

e * (D) Dump Mode Switch - Files containing data in an ab- 
solute binary form (extension ABS) must be handled using 
the (D) mode switch. 


The specific combinataions of data mode switches and optional function 
switches which are permitted in each of the PIP primary operations are 
given in Section 3. 


Table 2-5 

Data Modes and Data Mode Indicators 


DATA MODES 




IOPS 

ASCII 

IOPS 

BINARY 

DUMP 

IMAGE ALPHA/ 
NUMERIC 

IMAGE 

BINARY 


SRC 

/ 





FILENAME 

EXTENSIONS 

BIN 


/ 




ABS 



/ 




Numeric 

/ 






(A) 

/ 






(B) 


/ 




OPTION 

CD) 



/ 



SWITCHES 

(I) 




/ 



(H) 





/ 


Files that contain more than one data mode per file cannot be manipulated 
using PIP. The XY11 plotter handler, XYA. , accepts consecutive write 
commands in a combination of both IOPS ASCII and IOPS BINARY modes. 
Further, a user program could create a mixed-mode file on a mass stor- 
age device. 
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DATA MODE SWITCHES VS. FILENAME EXTENSIONS 


From Table 2-5 it can be seen that switch options (A) , (B) and (D) 

specify the same data modes as filename extensions SRC, BIN, and 
ABS. Only one data mode indicator is needed in a command string; 
if the filename extension is given, its corresponding data mode 
switch is not required; conversely, the extension is not needed if 
the switch is given. To illustrate: 


THE COMMAND 

a) T, iDKi_|FILEA-*-DT2i iOLDFILi iSRC J a) 

b) T,__iDK|__iFILEA+-DT2i__iOLDFILi_iBIN J b) 

c) Ti iDKi__iFILEA-*-DT2 , 1 OLDFIL 1 iABS J c) 


IS EQUIVALENT TO: 

T t_j DKi_j F I LE A«-DT 2 l_,OL DF I L t_i ( A )J 
Ti__iDK l _iFILEA+-DT2i_jOLDFIL i_i(B) > ) 
Ti_jDKi_iFILEA-*-DT2i— lOLDFIL i_i(D)V 


Files with extensions used by PIP to determine data modes must not 
actually be of another mode. PIP will refuse to transfer the file if 
the data mode derived from the command string does not match that in 
the first header word of the file. For example, FILE1 BIN should be 
a file written in IOPS binary mode (0 in bits 14-17 of the first header 
word). It should not have been written, for example, in IOPS ASCII 
(2 in bits 14-17) and then had its extension changed to BIN. 


2.3.7 PIP UFD and File Protection Codes 

In performing PIP operations which involve User Directories and/or the 
files which they contain, the user must be aware of the UFD and file 
protection codes involved. These codes determine the accessibility 
of the UFD's and of the files which they contain. 

New Protection codes may be assigned by the user or, by default, by 
the system. Existing codes may be modified using PIP command R. 

(refer to Section 3) . 

UFD's may be assigned the following codes: 

DIRECTORY PROTECTION CODES 

0 unprotected: any user may access, manipulate 

the contents, and delete an un- 
protected UFD. 

1 protected: only the user logged in under 

the UIC of the UFD (or the MIC) 
may write into a protected UFD. 

NOTE 

The Default value for UFD directory protection 
codes is always 1. 
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Files may be assigned any of the following protection codes: 

FILE PROTECTION CODES 
PERMITTED OPERATIONS 


CODE 

READ 

WRITE 

PROTECTION GIVEN 

1 

yes 

yes 

unprotected 

2 

yes 

no 

write protected 

3 

no 

no 

protected 

none 

SYSTEM 

DEFAULT VALUE 1 


given 

NOTE 

File protection codes are valid 

only when the 


UFD in which they 

are located is 

protected 


(code 1) . 


1 The system default value for file protection codes is set by the sys- 
tem manager (MIC) during the initial configuration of the system U.e 
system generation) . 
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CHAPTER 3 


PIP OPERATIONS, DETAILED DESCRIPTIONS AND EXAMPLES OF USE 


3.1 INTRODUCTION 

This Chapter contains descriptions of the PIP operations which may 
be performed by the standard (UIC) DOS system user. The PIP opera- 
tions unique to the system manager (MIC) are described in chapter 4. 

3.2 N: DIRECTORY SETUP OR INITILIZATION OPERATION 
The New Directory, N, operation permits the user to: 

a) create a new UFD for the currently logged-in UIC 
or a specified UIC, 

b) initialize an established UFD for the current UIC 
or a specified UIC, 

c) initialize and change the protection code of the 
UFD for the current, or a specified UIC, 

d) delete the UFD of the current or a specified UIC 
from the system (i.e., remove its name from the 
MFD) , 

e) initialize the directories of peripheral file- 
structured mass storage devices. 


WARNING 

Each time the N command is used, all of the 
files on the directory involved are DELETED. 
Care must be taken to ensure that needed files 
are not lost. 


1 Utility program MTDUMP must be used to initialize directories on Mag 
tape units (NTn) . Refer to the MTDUMP XVN Utility Manual for a 
description of MTDUMP and its use. 
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Each of the preceding functions and the command format required for its 
execution are described in Sections 3.2.1 through 3.2.5. 

3.2.1 Create/Initialize Current UFD 

The command : 

\ 

>N C _ J DKV 
is used either to: 

a) establish a User File Directory (UFD) for the current 
UIC, or 

b) initialize (delete all files from) an existing UFD set 
up for the current UIC. 

For example, if the current UIC is "GEP" the new or initialized UFD 
resulting from the above command has the format: 


9 A~ m CM- 7 1 ! 

DIRECTORY LISTING (GEP) 

1 147 FREE BLKS 
0 USER FILES 
0 USER BLKS 

UFD ' s set up or initialized using the basic N command (i.e., N, ,DK^/) 

are automatically assigned a default protection code of 1 (write 
operation permitted only to the current UIC) . 

The current UIC can use the basic N command to set up UFD ' s under 
other UIC codes by specifying another UIC in the N command. For 
example, the current UIC "JAN" can set up a UFD under the UIC "ABC" 
with the command: 

>N l _ 1 DK,__i<ABC 

UFD 1 s set up in the above manner are automatically assigned a protec- 
tion code of (unprotected) . 

Any unprotected UFD located on the disk being accessed may be initial- 
ized by the current user if he knows and specifies its UIC. For 
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example, an unprotected UFD with a UIC of "SCR" is initialized by 
the command : 

>N j _ i DK u <SCR> ) 

3.2.2 Setting up the UFD Protection Code 

UFD protection codes may be specified in the N command to: 

a) set a desired protection code for a new current or 
specified UFD, 

b) change the protection code of an existing UFD. 


The command formats used for these functions are: 


a) >N U DK U (X) ) 

b) >NJDKJ AAA> 0 (X) ) 


for current UIC UFD. 
for specified UFD's. 


where : 

(X) 
< AAA> 


represents the desired protection code 
represents the specified UIC. 


The UFD protection codes are : 


1 protected write operations only permitted 

by the UIC or the system MIC. 

0 unprotected read/write operations permitted 

to all users. 


The following are examples of the uses of the above N command formats 


a. The command: 


>NJ3K L _ l (j2(); 

creates or initializes the current UFD with a direc 
tory protection code of 0 (unprotected) . 


b. The command: 


>NJDK l f ABC> U (1)^ 
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creates (or initializes) the UFD "ABC" with a speci- 
fied protection code of 1 (unprotected) . Remember, 
if this type of command is used, the current user 
cannot access the specified UFD since it will be 
protected. 

The R command, Section 3.9.3 should be used to change 
the protection code of an existing UFD unless the 
UFD is to be initialized (all files deleted) . 

3.2.3 Deletion of UFD's 

The PIP N command permits the user to delete the UFD of the current 
UIC and specified unprotected (code $) UFD's from the system (i.e., 
remove their names from the MFD) . 

The "delete" function is set up by the addition of the "K" function 
switch to the basic N command, as follows: 


a) >N l _,DK l _,(K)^ deletes the UFD of the current UIC 

b) >N|__iDKi_j<XXX>u_i(K)V deletes the UFD of a specified UIC 

(<XXX >) . 

For example, assume the following Master File Directory (MFD) as being 
current : 


24-N0V-75 

MFD DIRECTORY LISTING 
5753 FREE BLKS — 
47 USER FILES 
SI 2 USER BLKS 
A BL NONC0) 

XYZ NON (0) 

\ \ 

UFD UIC' 6 UFD 


0 

0 




protection code 


Current date 

Number of free device blocks 
Number of user files on device 
Number of device blocks occupied 
by files 

Entries of Unprotected UFD 's 


NOTE 

Listings of the current MFD as shown above _ 
are obtained using the PIP List (L) operation. 


The commands : 

> N l _ J DK 1 _j< ABL > i_»(K)^ 

>N l _,DKi KXYZ ><— *(K) J 

Delete the unprotected and non-current UFD's ABL and XYZ from the disk 
Their deletion is illustrated by the resultant MFD: 
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S4-N0V-75 

MFD DIRECTORY LISTING 
5753 FREE BLKS 
47 USER FILES 
(SI 2 USER BLKS 

3.2.4 Initialization of DECtape Directories 

The directories of DECtape storage devices may also be initialized 
using the N command. The command format is: 

> N device mnemonic and unit number J 

For example, the command: 

\ 

>Nu_,DTiy 

initializes the directory of the tape mounted on DECtape unit 1. 

NOTE 

When a DECtape is initialized, the tape's File 
Bit Map blocks are cleared and the Directory 
Block is set up to indicate that only the File 
Bit Map and Directory Blocks are occupied. 

3.2.5 (S) Switch: Setting up DECtape Directories with +Q Areas 

The optional function switch (S) added to DECtape N commands both 
initializes the device directory and causes a CTRL Q area (IQAREA) 
to be reserved on the DECtape for core -t-Q-dump operations as per- 
formed by the QDMP XVM utility program. The (S) switch is the only 
switch permitted in N DECtape commands. The basic command format 
is : 


> N. .device mnemonic & unit number i_i 


{S)J 


The (S) switch used: 

a) alone indicates that the size of the reserved 

+QAREA should be the same as the current 
system core size. For example, the com- 
mand: 


>Ni_iDTlt_i 


(S)J 
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in a system running in 16K of core establishes 
a 16K 1QAKEA (word locations) on the tape 
mounted on DECtape unit #1. 

b) with a one or two digit number (i.e., (Snn) ) , 

specifies the size of the 1QAREA to be reserved 
on the tape mounted on the DECtape unit. 

For example, the command: 

N DTI (S24 ) 

causes a QAREA, 24K in size, to be reserved 
on the tape mounted on DECtape unit #1. 

3.3 L: DIRECTORY LIST OPERATION 

The List, L, operation enables the user to obtain copies of both disk 
and DECtape directories in: 

a) punched tape form, 

b) printed form, or 

c) as a CRT display. 

Copies of directories which contain only selected file entries may 
also be obtained. 

The basic command format used in L operations is: 


>Li_jlisting device-<-source device^ 

where : 

a) the 

listing device may be the: 

] ) 

console teleprinter (TT) 

2) 

line printer (LP) , (LV) 

3) 

paper tape punch (PP) 

4) 

optional CRT display devices (refer to 
Appendices A and B) 

5) 

XY plotter 


b) the source device may be any directoried mass storage 

device within the system (i.e. , DK, RKn, DTn, DPn) . The 
exceptions are magtape directories which cannot be listed 
with PIP; MTDUMP must be used. 
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Three optional switches may be used within an L command; they are: 

a) (M) , list Monitor MFD table 

b) (L) , list Monitor SYSBLK table 

c) (P) , used only in UFD list operations, this switch causes 

additional file protection and file storage information 
to be included in the requested listing. 

The various list operations which may be performed, the required L 
commands for each, and examples of the listings obtained are described 
in Sections 3.3.1 through 3.3.6. 

3.3.1 List UFD for Current or Specified UIC 

The UFD for a current UIC located on a disk device may be listed 
using the basic L command format. 

For example, assuming a current UIC of "GEP", the command: 

>L,_ I LP DK J 

produces a printout of the UFD with a format similar to the following: 


Z A - MG V- 75 

DIRECTORY LISTING (GEP) 
1131 FREE BLKS 


3 USER FILES 
6 USER BLKS 


PART A 

SRC 

1 

•' J\ !/«. 7" 

PARTB 

SRC 

2 

/"> /. _ • i <•> \ J_ 7q 

PARTC 

SRC 

3 

y, _ r.* r\ \j _ nr^ 

k 

J 

\ 

\ 


V 


CURRENT DATE 

DIRECTORY IDENTIFICATION CODE (UIC) 

NUMBER OF FREE BLOCKS ON THE DEVICE 
NUMBER OF USER FILES CONTAINED BY THE UFD 
NUMBER OF DEVICE BLOCKS OCCUPIED BY 
THE UFD FILES 

DIRECTORY USER FILE ENTRIES 


DATE USER FILE WAS ENTERED INTO UFD 


NUMBER OF DEVICE BLOCKS 


OCCUPIED BY FILE 


FILE FILENAME AND EXTENSION 


The current user may also obtain a listing of any unprotected UFD 
in the system by specifying its identifying UIC in the L command. 
For example, the command: 

> L l _ l LP-*-DKi_i< JAN>>^ 

causes the printout of the unprotected disk UFD identified by the 
UIC "JAN". 
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3.3.2 (M) Switch: List MFD 

A listing of a disk Master File Directory (MFD) may be obtained by 
the addition of the (M) switch to the L command. For example, a line 
printer listing of a DECdisk MFD is produced by the command: 

> L|_jLP-*-DK|_j (M) ^ 

The listing produced would have a format similar to the following: 


2 4- NOV- 75 CURRENT DATE 

MFD DIRECTORY LISTING 

1147 FREE RLKS NUMBER OF FREE BLOCKS ON THE DEVICE 

52 USER FILES NUMBER OF USER FILES ON THE DEVICE 

1616 USER BLKS NUMBER OF DEVICE BLOCKS OCCUPIED BY USER 

TUK 1003(0) 6 114\ FILES 

PIP 2532(0) 1 76 A - USER FILE DIRECTORIES 



NUMBER OF DEVICE BLOCKS OCCUPIED BY 

SPECIFIED UFD FILES 

NUMBER OF FILES CONTAINED BY THE SPECIFIED UFD 
FILE PROTECTION CODE 
NUMBER OF FIRST DEVICE BLOCK OCCUPIED BY UFD 


UFD IDENTIFIER (UIC under which it was created) 


NOTE 

MFD listings obtained by standard users (UIC's) 
list only the unprotected UFD entries. Only 
the system manager (MIC) can obtain a complete 
list of both protected and unprotected UFD's. 


3.3.3 (L) Switch: List Monitor SYSBLK 

The addition of the (L) switch to a list command made to the disk 
device containing the operating system results in a printout of the 
system block (SYSBLK) table on the selected listing device. For 
example, assuming a DK system device, the command 

>L I _ J LP^-DK I _ 1 (L)^ 

produces a listing of the system SYSBLK on the system line printer , 
with a format and contents similar to the following: 
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SYSBLK LISTING 


X 


PROGRAM NAME 


NAME 

FB 

NB 

FA 

PS 

SA 

.SYSLD 

0 

40 

100 

17400 

0 

DOS 1 5 

40 

33 

1352 

14526 

1742 

fQAR EA 

101 

200 

5 

77773 

0 

BOSS 1 5 

301 

16 

12411 

71640 

54020 

EDIT 

317 

1 5 

12001 

5636 

12002 

EDITVP 

334 

17 

10277 

7340 

10551 

EDITVT 

353 

17 

10302 

7335 

10553 

PIP 

372 

35 

1526 

16111 

1671 

QFILE 

427 

2 

1 7041 

437 

17045 

MA CRO 

431 

33 

2630 

15005 

2630 

CREF 

464 

5 

1 5450 

2137 

1 5451 

CHAIN 

471 

21 

7600 

10037 

7600 

E4 

512 

35 

2176 

1 5441 

2323 

DUMP 

547 

5 

1 5300 

2337 

1 5300 

DTCOPY 

554 

3 

16662 

755 

1 6701 

PATCH 

557 

10 

12700 

3453 

12700 

UPDATE 

567 

13 

12370 

5247 

12371 

SRCCOM 

602 

13 

12674 

4743 

12777 

STRAN 

615 

1 1 

13607 

4030 

13671 

89TRAN 

626 

1 1 

13562 

4055 

13644 

MTDUMP 

637 

12 

13167 

4450 

13260 

SEEN 

651 

35 

5740 

10163 

6004 

TKB 

706 

21 

7573 

10044 

7750 


Number of 
blocks 
allotted 
to program 


Number of 
first device 
block oc- 
cupied by 
program 




First core 
address oc- 
cupied when 
program is 
loaded 


Program size, 
number of 
word locations 

X - 

Program 
starting 
address 


SYSBLK supplies a complete listing of the language and utility pro- 
grams contained by the system; the names listed in SYSBLK are the 
keyboard commands required to call (i.e., load) the listed program 
into core. 


3.3.4 (P) Switch: List UFD with File Protection Codes and RIB 

Pointers 

The optional switch (P) added to an L command causes file protection 
code, file starting block number, and RIB data to be added to each 


^"Retrieval Information Block, contains pointers to the non-contiguous 
file storage blocks (refer to the XVM/DOS Users Manual, for a 
complete description of this table) . 
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file entry contained by the UFD. For example, assuming the UIC "JAN" 
to be current, the command: 

Y 

>L l _,LP h< “DK V 

produces the following printout: 


£4- NOV- 75 

DIRECTORY LISTING (JAN) 

1125 FREE BLKS 

1 USER FILES 

2 USER BLKS 

CRDFL BIN 2 2.4-NQV-75 


CURRENT DATE 

UFD IDENTIFIER 

FREE DEVICE BLOCKS 

NUMBER OF USER FILES 

NUMBER OF USER FILE DEVICE BLOCKS 

USER FILE ENTRY 


To illustrate the use of the (P) switch, the command: 
>L,_jLP^DK,_j(P) J 

produces the following printout: 


NOTE 


Only the information added by the (P) option 
is indicated. 


2 4-NO V- 75 

DIRECTORY LISTING (JAN) 
1125 FREE BLKS 

1 USER FILES 

2 USER BLKS 
CRDFL BIN 2553(2) 



-NOV- 


2552 

V 


0 


z 


POINTER 

TABLE 


POINTER TO THE FIRST RIB WORD IN BLOCK 
TO DEVICE BLOCK CONTAINING FILE RIB 


CURRENT FILE PROTECTION CODE 
-FIRST BLOCK OF FILE 


3.3.5 List DECtape Directories 


The directory of any DECtape storage device within a system can be 
listed using the basic L command. For example, the command: 


>L uTT-'-DT 1 J 

causes the directory of the tape mounted on DECtape Unit fl to be 
listed on the console printer. Directory listings have a format 
similar to that of the following example: 
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DIPECTOPY LISTING 
I0S2 FREE BLKS — 
USEF FILES - 
SYSTEM BLKS 




CURRENT DATE 

NUMBER OF FREE BLOCKS ON DECTAPE 
NUMBER OF USER FILES ON DECTAPE 
NUMBER OF DECTAPE BLOCKS OCCUPIED 
BY DIRECTORY AND FILE MAPS (also 
by Monitor if a system DECtape) 
DIRECTORY FILE ENTRIES 


NUMBER OF BLOCKS OCCUPIED BY FILE 
FIRST BLOCK OCCUPIED BY FILE 
FILENAME AND EXTENSION 


Option switches (M) and (P) are illegal for devices other than disk 
devices (i.e., DK, RKn and DPn) . The (L) switch, however, may be 
used with DECtape if the DECtape contains an ADSS operating system. 

3.3.6 List Selected File 


The directory entries of specific files or groups of files in a cur- 
rent UFD , a specified UFD, or a device directory may be listed selec- 
tively by adding elements to the L command. 


To list the directory entry for a specific file, add its filename 
and extension to the L command. For example, assuming the following 
UFD to be current: 


o Ji 


75 


DIRECTORY LISTING 

(GEP) 

1 131 

FREE 

BLKS 


5 

USER 

FILES 


15 

USER 

BLKS 


PARTA 

SRC 

1 

p MOV- 75 

PARTB 

SRC 

1 

24- NO '1-7 5 

PARTC 

SRC 

1 

2 4-NO U -75 

CRDFL 

BIN 

2 

2 4 - MPV/-75 

TEST 1 

001 

10 

24- POM-75 



J 


DIRECTORY READER 


FILE ENTRY LIST 
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the command : 

>L^LP,_ J TESTl l _ J 0rj?l-<-DK^ 


produces the following line printer listing: 


24 - wo V- 75 

DIRECTORY LISTING (GEP) 

1131 FREE BLKS 
5 USER FILES 
15 USER BLKS 

TEST1 001 10 24-N PV-75 


NOTE THAT THE HEADER REMAINS 
UNCHANGED 


DIRECTOR Y ENTRY OF SELECTED 
FILE 


All files within a directory which have a common filename extension 
may be listed as a selected group. The required L command format is: 

>Li_jlisting dev .i_j #XXX+ source dev.> 


where : 


a) # indicates the function, 

b) XXX is the common filename extension. 

For example, assuming the UFD "GEP" to be current, the command: 
>L l _,LPi_, #SRODK J 


produces the following line printer listing: 


24 -NOV-75 

DIRECTORY LISTING (GEP) 
1131 FREE BLKS 
5 USER FILES 
15 USER BLKS 
PARTA SRC 1 24 

PARTB SRC 1 2/' 

PAR TC SRC 1 


- in V- rj 
-NOV- 75 


NOTE THAT THE INFORMATION CON- 
TAINED BY THE DIRECTORY HEADER 
IS UNCHANGED 


LIST OF FILE ENTRIES WHICH HAVE 
THE COMMON EXTENSION "SRC". 
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The (P) optional switch may be used in "selected file(s)" L com- 
mands. For example, assuming the UFD "GEP" to be current, the com- 
mand: 


>LJ J P U TEST1 1 J2(01 U (P ) ^DK ) 


produces the following line printer listing: 


2 A- \;C: V- 75 

DIRECTORY LISTING (GEP) 
1131 FREE BLKS 
5 USER FILES 
15 USER BLKS 

TEST 1 001 2542(2) 10 


NOTE THE ADDITION OF THE FILE FIRST 
BLOCK NUMBER, PROTECTION CODE, 
POINTER TO THE FILE'S RIB AND FIRST 
RIB BLOCK. 

24- NOV-75 2551 10 


Files may also be "selectively listed" from DECtape directories by 
using the device mnemonic and unit number (i.e., DTn) as the command 
"source device". The (P) option cannot be used in DECtape L commands. 


3.4 T: FILE TRANSFER COMMANDS 


The transfer of files between standard I/O devices is carried out by the 
"T" operation. During a basic T operation, data is read from a source 
device and is written into a named area (file) on a specified destina- 
tion device. In addition to basic Read/Write transfers, PIP permits 
performance of more complex operations by the use of optional func- 
tion switches. For example, transfer operations may include such 
optional functions as : 


a. the correction of parity errors, 

b. the conversion of tabs to spaces and vice-versa, 

c. the segmentation of large files or the combination 
of small files into a single file to be performed 
as part of the T operation. 


The T command string format is described in detail in Section 2. How- 
ever, as a reminder, the basic elements are: 1 


>T l I 


— - 


“ ~ 




— — 


_ — 



dest . 
device ; 
mnemonic^ 

{ I 

dest. 
file name 

1 1 

ext. 

— 

source 

device 

t 1 

source 

filename 

i i 

ext 


For example: 

>T l _ 1 DKJ)ESTFL | _ l BIN^DTl u SOURCE l _ l BIN ) 
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The following items should be observed when structuring a "T" com- 
mand: 

a. During transfers between directoried devices, the 
filename extension of the source file or an equivalent 
data mode switch must be given to ensure that PIP can 
find the source file. For example: 

>Tl_iDK 1 _jFILEA^DT1 i _,S0URCEi_iSRC J 

b. During single file transfers, the destination file is 
named only if the name is to be different from that of 
the source file. For example: 

1. >T,_,DK-*-DTl l __ I SOURCE u _ 1 SRC ) 

results in the contents and name of DTI file "SOURCE 
SRC" being added to the current UFD. 

2. > Ti_,DK, 1 NUFIL+ DT 1l_j SOURCEi_jS RC J 

results in the contents of DTI file "SOURCE SRC" being 
transferred to the current UFD under* the name "NUFIL 
SRC" . 

c. More than one file may be transferred in one T opera- 
tion: the files, however, must be in the same data 

mode. In multi-file transfers, the listed filenames 
must be separated by commas; the common extension 
(BIN, ABS, or SRC) or an equivalent data mode switch 
is required only once in the series. For example: 

>Ti_jDKi_jTESTA, TESTB-^DTlt-jFILEA , FILEBujSRC J 

transfers two files from DTI into two differently names 
file areas of the current UFD, both with the extension 
SRC. Although an extension ending in a numeric (001, for 
example) will automatically imply IOPS ASCII, it cannot 
be used as a common extension for all files in the series 
by specifying it only once. For example: 

>T|_jDKi_jTESTA,TESTB-^DTli_iFILEA,FILEBi_i001^ 

transfers FILEA SRC to the disk as TESTA SRC and FILES 
i_j001 as TESTB SRC. 

d. During multiple file transfers in which the source names 
are to be retained on the destination device, commas 
must be used on the destination side of the command. 

The commas indicate to PIP the number of files involved; 
the number of commas used must be one less than the num- 
ber of source files. For example, the command: 

>Ti_iDKi_i, , DT1i_jFILEA,FILEB,FILECi— iSRC J 

effects the transfer of three files from DTI to the 
current UFD. Note the use of two commas, one less 
than the number of source files specified. 
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e. Whenever optional switches are added to a T command, 
they may be placed on either side of the dividing 
symbol (i.e., 

> Ti_jDT i__i(N) *■ DKi 1 FILEA 1 i (A)^ 

3.4.1 Required Data Mode Specifications 

In transfer operations, the form of the data being handled must be in- 
dicated in the command string either by a Data Mode Option switch or by 
the Filename extensions used. 

The use of data mode switches or filename extensions in command strings 
is described in Section 2.3.6. The specific combinations of data mode 
switches and optional function switches permitted within the Transfer 
command are listed in Table 3-1. 


Table 3-1 

Legal Data Mode and Function Switch Combinations 
for Transfer Operations 

DATA MODE FUNCTION SWITCHES 

SWITCHES EGCWYNSFTQ 

A X X X X X — X — X X — X X 

I I I 

B X X — X 

I I 

I X — X 

I I 

H' X X 

I I 

D X X 

3.4.2 System Device File Protection Codes 

During file transfer operations between disk storage devices or UFD's, 
the user may specify a protection code for the transferred file. (File 
protection codes are listed and described in Section 2.3.7. 

For example, assuming that the UFD "JAN" is current: 

2 /i- *JCV- 73 

DIRECTORY LISTING (JAN) 

2263 FREE RLKS 
0 USER FILES 
0 USER BLKS 

and that the system file protection code default value is 2, the fol- 
lowing series of commands : 
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>T l _ i DKi-DT1l_iSEGA {&)J 
>T4_iDK+-DT1i_iSEGB (A1)J 
>Ll_iLP^DKuj(P)v ) 


transfers files "SEGA" and "SEGB" from the tape mounted on DECtape 
unit #1 and lists the directory "JAN" with the applicable file pro- 
tection and RIB data: 


fM-';0V-75 


DIRECTORY LISTING (JAN) 

2260 FREE BLKS 
2 USER FILES 
2 USER BLKS 

SEGA SRC 1313(2) 1 24-NCV-75 1313 

SEGB SRC 1312(1) 1 24-N0V-75 1312 


Z_ 


file 


protection 


code 


56 

24 


As shown in the directory, file SEGA was assigned the default pro- 
tection code while file SEGB was assigned the specified value (i.e., 1) . 


3.4.3 File Transfers to Disk 


Files may be transferred to disk devices from any standard input or 
mass storage device within the system. An entry for each file trans- 
ferred is listed in the current or specified UFD . Files may be trans- 
ferred: 

a) as a complete copy of the source file including the 
same filename; 

b) with the same filename but a specified file protec- 
tion code; 

c) with a new name specified for the destination file. 

Sample illustrations of the above functions appear below. 


(A) >T DK*-DT1 TEST1 001 transfer file, keep same name and 

accept system default file protec- 
tion code. 

CBl >T DK-DTl TEST2 002 (1) transfer file , keep same name but 

specify desired file protection 
code . 
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CC) >x DK DESTFL<-DT1 TEST1 001 (1 ^transfer file 3 rename file and 

specify desired file protection code . 

2 4- MOV- 7? 

DIRECTORY LISTING (GEP) 

5717 FREE BLKS 
3 USER FILES 
33 USER BLKS 


TEST1 

001 

1 605C2) 

10 

24- MOV- 75 

1650 

10 

TEST2 

002 

1652(1) 

13 

2 4- NOV-75 

1 676 

66 

DESTFL 

SRC 

1700(1) 

10 

04 - NOV-75 

1716 

10 

_Z 

1 




Filename extension Protection code 

3.4.4 UFD to UFD File Transfers 


Files may be read from: 

a) unprotected UFD's (code 0) ; 

Example command: 

>Ti_iDKi_j+-DKi_j>JAN>i_jTESTl i_j ( A)^ 

b) protected UFD's (Code 1) if the file protection code of 
the desired file permits the operation; 

Example command : 

>Ti_jDK «r DKi_i<JAN>«_iFILEAi_j(B) / ) 

c) the current UFD and written into another, unprotected 
(code 0) UFD; 

Example command: 

>Tl-iDKi_i< JAN> t- DKujEXAMPi_j {A)) 

d) one file of the current UFD into a second, differently 
named, file of the current UFD. 

Example command: 

>Ti__iDKi_jNUFIL «- DKi_jOLDFILL i_i(A)y 


NOTE 

UFD and file protection codes of input 
files need not be considered in transfer 
operations with the current UFD. 

Files may be written into: 

a) unprotected UFD's (code 0 ) ; 

Example command: 

>Ti_jDKi_j<JAN> +- DKs__iTESTl i — i ( A)y 

b) the current UFD or a specified file within the current 
UFD. 

Example command: 

>Tl_jDKi_iTEST1 DKi_i<JAN>i_iPATCHi_j(A)V 
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In addition to the above, transfer operations may be carried out between 
files of the current UFD including the creation of a new file from an- 
other file within the UFD. For example, assuming the following UFD as 
current: 


MOV- 75 

directory LISTING (GEP) 


1 500 

FREE 

BLKS 





3 

USER 

FILES 





24 

USER 

BLKS 





TEST1 

001 

5214(2) 

10 

2 4- NOV- 75 

5232 

10 

TEST2 

002 

5234(2) 

13 

2 4- NOV- 75 

5257 

66 

CONTS 

SRC 

5261 (2) 

1 

2.4 - NOV- 75 

5212 

0 


The command : 

^U DK U COUNTS LJ SRC ^ DK Lf ONTS u(l> ) 


creates a new file "COUNTS SRC" from file "CONTS SRC", giving the new 
file a protection code of 1. 


The operation performed results in the following UFD: 


p.4- NOV- 75 
directory listing 


(GEP) 


New file 


1476 

FREE 

BLKS 




4 

USER 

FILES 




25 

USER 

BLKS 




TEST1 

001 

5214(2) 

10 

P.4-M0V-75 

5232 

TEST2 

002 

5234(2) 

13 

2 4 - NOV-75 

5257 

CONTS 

SRC 

5261(2) 

1 

24- NOV-75 

5212 

COUNTS 

/ 

SRC 

5265(1 ) 

/ 

1 

P 4- NCV-75 

52 63 

/ 

le 

Specified. Protection 

code 



10 

66 

0 

0 


The capability of performing transfer operations within current UFD ' s 
simplifies these operations and enables the user to take full advantage 
of the interactive speeds of disk devices. 


3.4.5 Device to Device File Transfers 

The read/write transfer of files between non-disk mass storage devices 
and/or I/O devices is performed using the same types of commands as 
described in the preceding paragraphs. Protection codes and user pass- 
words (UIC's), however, are not required since these items are unique 
to disk file structures. Typical examples of device to device command 
strings are: 
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a) DECtape 2 to DECtape 1 transfer: 

> T u_iDT li_i NE WF I L+- DT 2 ,_jOL DF I L i_j ( A )J 

b) Papertape Reader to DECtape 1 transfer: 

>Ti_iDT1i_iNEWFILi_iSRC ■*- PR J 

NOTE 

When inputting information from paper tape, 
it is recommended that the (I) data mode 
switch be used if the contents of the tape 
are unknown. 

c) DECtape 1 to Line Printer (listing) : 

> Ti_jLP-HDT1ujNEWFILi_i (h)J 

3.4.6 Transfer of Keyboard Inputs to Output Devices 

The PIP transfer "T" command may be used to transfer console terminal 
keyboard (device TT) entries (line by line) to output devices as they 
are typed. This capability is useful in the creation of ASCII source 
paper tapes or the entry of personal comments at the beginning or end 
of line printer listings. The user, however, should consider that the 
text editorial and correction features provided by PIP are minimal 
and that the service program EDIT provides complete editorial func- 
tions. 

Once started, transfer operations of this type must be terminated by 
a CTRL D (ID entry) . The CTRL D entry must be made on a separate line, 
since any data on the same line as CTRL D will be deleted from the 
output. 

Examples : 

a) To punch a paper tape via keyboard entries, use: 

\ 

>T,_,PP,_i (A)-<-TT V 

b) To enter data directly from the keyboard into the current 
UFD, use the following (note that a file is named in the 
command to receive the keyboard inputs) : 
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Key boavd-to -Disk 

>T DK KEYBD-TT (A) Transfer Command 


THIS IS AN EXAMPLE OF THE MANNER IN WHICH DATA CAN 
BE ENTERED INTO A FILE ON THE DISK DIRECTLY 
FROM THE CONSOLE KEYBOARD. 

THE EDITORIAL COMMANDS FOR CHARACTER RUBBOUT 
AND LINE DELETION MAY BE USED IN THIS MODE OF 
OPERATION. FOR EXAMPLE 

.TITALWLE EXANPWMP 
A CTRL D ENTRY MUST BE MADE TO TERMINATE 
THE KEYBOARD ENTRY MODE OF OPERATION. 

+D 


>T TT«-DK KEYBD SRC 


File to Teleprinter 
Command 


THIS IS AN EXAMPLE OF THE MANNER IN WHICH DATA CAN 
3E ENTERED INTO A FILE ON THE DISK DIRECTLY 
FROM THE CONSOLE KEYBOARD. 

THE EDITORIAL COMMANDS FOR CHARACTER RUBBOUT 
AND LINE DELETION MAY BE USED IN THIS MODE OF 
OPERATION. FOR EXAMPLE 
.TITLE EXAMP 

A CTRL D ENTRY MUST BE MADE TO TERMINATE 
THE KEYBOARD ENTRY MODE OF OPERATION. 


Note the change in the .TITLE line as 
compared with the previous example 
where rubouts were used. 


Inpu ts 
from 

Keyboard 


Te leprinter 
listing of 
Fi le 

KEYBD SRC 
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3.5 FILE TRANSFERS WITH OPTIONAL FUNCTIONS 

As stated in Section 3.4, PIP option Function Switches may be included 
in "T" commands to provide the use of a broad variety of secondary 
operations during file transfers. The legal switches and switch com- 
binations permitted in T commands are given in Table 3-2. 


Table 3-2 

Legal Combinations of Function Switches in 
Transfer Operations 


w 


N 


E 

G 

C 

W 

Y 

N 

S 

F 

T 

Q 


— X- 

I 

-X X- 

I I 

•X X- 

I I 

-X — X- 

1 i 

-X X- 

I ! 

-X X- 

I 

x- 

I 

X- 




7 Y 

7 V V \ 

r 


/v / 

1 1 
7 V A 

\ z 

1 

/ \ 

Y 7 

1 

r \ 

1 

/ \ 

Y 


V z 

r- ' 

1 / 

7 . _ \ 

Y ■ r 

1 

7 \ 

Y 2 

1 

7 Y 

\ / 

i 

r y 

Y 

- Y 

7 

\ 2 

Y /Y Z 

1 1 1 

. V ___ V \ 

\ 

1 


A A / 

1 i 1 

\7 \7 -- \ 

Y 

A 

1 

v — - \ 

7 y 

1 

7 

Y / 

Y / 

^ 

A 2 

1 ! 

Y Z 

\ 





1 

7 Y 

7 A 

7 




. -A. / 

1 

\ z 

1 

\ 




A A 

1 1 

X 





X — 

I 

x — 
I 

X — 

I 

•X 

I 

■ X 

I 

■ x — 


-x — x — x- 

I I I 

•X X X- 


-x- 

I 

X- 


■x 

I 

X 


The operations provided by the use of switch functions are described 
in Sections 3.5.1 through 3.5.8. 

3.5.1 (G) Switch: Parity/Checksum Error Correction Facility 

During data mode (A) or (B) File Transfer operations, PIP checks the 
parity and checksum of the file(s) involved. If an error is detected, 
PIP interrupts the transfer and outputs on the console printer the 
message : 

PARITY ERR 
or 

CKSUM ERR 
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depending on the error found. During (A) mode transfers, each parity 
error message output is followed by a listing of the line containing 
the error. Such errors detected during a Transfer without the (G) 
switch cannot be corrected. 

However, the addition of the (G) switch to (A) mode commands provides 
the user with the following options when a parity or checksum error 
is found: 


a. Accept the line containing the error as it is, by entering 
a J (RETURN) ; 

(PIP does not pass the parity error even if the line is 
accepted; it will change the incorrect parity bit to 
ensure even parity) 

b. Delete the line containing the error by typing D and 
proceed; 

c. Replace the line by typing in a new correct line which 
is terminated by ; 

d. Abort the transfer by typing CTRL P ( P) to restart PIP 
or CTRL C ( C) to return to the Monitor. 

The (G) switch may only be used in IOPS ASCII data mode (A) operations. 

The following is a typical example of the use of the (G) switch: 


COMMAND ; input contents of paper 
tape to file PARITY of current UFD 
and perform parity check with (G) 


>T DK PARITY (AG) -PR 
PARITY ERROR 


3EGIN. INIT 1 ,1 BEGIN 
> 

PARITY ERROR 


.ENTER , FILNAM 


> .ENTER 1, FILNAM — 

PARITY ERROR 

TAG .WRITE 1,2,@UF,34 

>TAG .WRITE 1 ,2,BUF,34 


T-. 


h 


functions . 

ERROR MESSAGE 

LINE III ERROR - user enters a RETURN 
to accept line as is. 

SECOND ERROR MESSAGE 
LINE IN ERROR 

-I user enters new line with correction. 
-I THIRD ERROR MESSAGE 


user enters new line with correction. 


3.5.2 (E) and (C) Switches: Tab-to-Space , Space-to-Tab Conversion 


Listing devices may or may not have tabbing mechanisms; therefore, 
it is sometimes necessary to convert file tab and space delimiters to 
meet the needs of the listing devices. 
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a) (E) Switch - the addition of switch (E) to a "T" 
command string causes all Horizontal Tab codes 
in the transferred file to be converted to the 
number of spaces required to achieve the same 
spacing of the printed material as would be ob- 
tained if a Tab were present. 

The (E) switch may only be used in data mode (A) 
transfer. Following is a typical example of a T 
command incorporating an (E) switch: 

> Ti_iTT+-DTli_jFILEA i_i( AE )J 

b) (C) Switch - the addition of switch (C) to a "T" 
command string causes any group of two or more 
continguous spaces to be converted to a Horizontal 
Tab code in the transferred file according to the 
following rule: 

i) a tab character is output for each 
tab-stop position which is reached 
or exceeded by the group of spaces. 

ii) any spaces occurring after the last 
tab stop position, which was reached 
by the group of contiguous spaces, are 
output. 

The effect of this operation is that a printout 
of the resulting file will look as if the C switch 
had not been invoked. The file itself is, however, 
shorter as the spaces have been corrected to tabs, 
and output should be faster depending on the output 
device. 

Note that any group of spaces which fails to reach 
at least one tab stop position will result in the 
output of just that set of spaces without any tab 
characters. Note further, that any group of spaces 
ending at a tab stop position will result in the 
output of tab characters without any spaces . 

The (C) switch may only be used in data mode (A) 
operations . 

The following is a typical example of a T command 
incorporating a (C) switch: 

>T l _ 1 TT-«-DTl U jFILEA !__i( AC}^ 


3.5.3 (N) Switch: Directory Initialization During Transfer 

In addition to being a Primary PIP operation, the New Directory N 
command may also be used as an optional function to be carried out in 
the context of ot.her operations. The (N) option may be used to initial 
ize directories on both disk and DECtape mass storage devices. 

Switch (N) , when used in a transfer to disk operation, initializes 
the UFD associated with the current user. 
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Used in a transfer to a non-existent UIC, the (N) switch causes a UFD 
to be set up under the specified UIC. The transferred file then appears 
as the first entry in the new UFD. 

Transfers made to DECtape devices by T commands containing the (N) 
switch initialize the DECtape directory and write the transferred file(s) 
onto the tape. 

The following example illustrates the use of the (N) switch in T 
commands . 

Assuming the file TESTl 001 to be present in the current UFD, the 
command: 


> T D K u < X Y Z > <- D K ^jT E S T 1 0 0 1 ( N ) ) 

sets up a new UFD under the UIC "XYZ" and transfers the file TESTl 001 
into the new UFD as its first entry as follows: 

24- NOV-75 

DIRECTORY LISTING (XYZ) 

1465 FREE BLKS 
1 USER FILES 
J0 USER BLKS 

TESTl 001 10 2 /i- NOV-75 

UFD's established in this manner are automatically given a UFD protec- 
tion code of "0", that is, unprotected. 

3.5.4 (W) Switch: Combining Files During Transfers 

The (W) combine file switch, when incorporated into a T command, enables 
the user to read two or more files from a source device and write them, 
in the indicated sequence, into a single file on the destination device. 

The (W) switch may be used with data mode switches (A) , IOPS ASCII and 
(B) , IOPS Binary. 

During (W) operations, PIP pauses and outputs a IP (when input is from 
a non-directoried device) at the console teleprinter after each file is 
transferred. The user must respond with a -t P entry to continue the 
transfer operation. 

For example, the command: 

>T l _ l DTl 1 _ 1 COMTST^DT2 l _ 1 TESTl ,TEST2 f TEST3 UJ (BW) > ’) 
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results in the binary files TEST1 , TEST2 , and TEST3 being written into 
the file COMTST on device DTI. With a source file, the pseudo-operators 
.EOT or .END which occur at the end of all but the last of the files 
being combined are deleted to enable the resultant file to be processed 
as a single continuous file. 


The following is an example of a combine files (W) , transfer operation: 


2 4- MQV- 75 
DIPECTOPY LISTING 
6 1 63 FPEE RLKS 
2 USEP FILES 
2 USEP RLKS 
SEGA SPC 1 

SEGB SPC 1 


(GEP) 

2. A - MOV- 75 [ 

2 A- MOV- 75 


LISTING OF CURRENT UFD 


>T DK EXAMP SRC <AW)«-DK SEGA SPC,SEGR SPC 


COMBINE FILES COMMAND 


2 4- NOV- 75 
DIPECTOPY LISTING 
6162 FPEE RLKS 
3 USER FILES 
3 USER RLKS 
SFGA SPC 1 

SEGR SPC 1 

EX AMP SPC 1 


( GF.P) 


2 A- NOV- 75 
24- NOV-75 
0.4- NOV-75 




LISTING OF CURRENT UFD 
SHOWING NEW FILE "EX AMP" 
CREATED BY COMBINING FILES 
"SEGA" AND "SEGB". 


.TITLE EXAMP 1 

.IODFV 1,2 I 

REGIN .INIT 1,1, BEGIN > LISTING OF FILE "SEGA" 

.ENTER 1.FILNAM 
.EOT J 


TAG .WRITE 1 ,2,RUF ,34 

.EOT 


) 


LISTING OF FILE "SEGB" 
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.TITLE EXAMP 
. I ODEV 1,2 

BEGIN .1 NIT 1,1, BEGIN 
.ENTEP 1 ,FILNAM 
TAG .WRITE 1 , 2 , BUF , 34 

.EOT 




LISTING OF NEW FILE "EX AMP” 




In the new file, EXAMP, the .EDT which was at the end of file SEGA 
has been omitted. 


3.5.5 Inputting and Combining Files from Paper Tape: (W) Switch 

The (W) option with a transfer operation permits the user to input files 
from separate paper tapes and to combine the files into a single named 
file on a specified destination device. 

The procedure required is: 


1) The first tape to be read should be loaded into the 
paper tape reader (PR) . 

2) The user must specify in the command string the num- 
ber of paper tapes to be read. This is done by fol- 
lowing the source device mnemonic (i.e., PR) by N-l 
commas ( , ) where N is the total number of tapes to 
be read. For example, the command: 

>T l _ I DTl UJ NUFILE t _ l (AW)- ( -PR |i _ J , , , ,) 

specifies that five (5) paper tapes (4 commas) are 
to be read in IOPS ASCII data mode and combined into 
a single file (NUFILE SRC) located on DECtape unit #1. 

3) The termination of the command string causes the first 
paper tape to be read. PIP pauses after each tape is 
read to permit the user to place the next tape in the 
reader. A pause is indicated by the printing of "tP" 
at the console printer. 

4) Until the last tape is read, the user must enter 
CTRL P (+P) after loading each new tape to continue 
the input operation. PIP determines which is the 
last tape to be read from the number specified in the 
command string and terminates the operation after 
the last tape is read. 


3.5.6 Card Input and Card File Modification Operations: (Q) , (C) , 

(T) Switches 

The transfer operation may be used to input source files from punched 
cards. The format of the data being input from cards may be modified 
by adding one or more of the following switches to the T command: 
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1) (Q) Switch - The addition of a (Q) switch causes 
the information input from card columns 73 through 
80 (card sequence numbers) to be deleted. This 
switch may be used only in an (A) data mode trans- 
fer operation and only on information which is in 
a card format. That is, the Q switch may be used 
during the transfer of files, the contents of which 
are still in card format, as well as during the in- 
put of data from the card reader. Examples of the 
command strings used are as follows: 

a) To modify input from card reader 

T,_,DTl u _ l FILEAi_i(AQ)-f-CD > J 

b) To modify file data format during storage 
device transfer operations: 

Ti |DTli_iFILEA + -DTli_iSOURCE i_i (AQ)^ 

2) (C) Switch - The (C) switch (spaces-to-tabs) may 
be combined with the (Q) switch to further modify 
the contents of files being input or transferred. 
The following is an example of a command string 
containing both the (C) and (Q) switches: 

Ti__,DTli_jFILEA-<-DT2|__»SOURCE i_j (AQC)^) 

3) (T) Switch - The (T) switch (delete trailing 
spaces) may be combined with the (Q) switch 
to further modify the contents of files being 
input or transferred. The following is an 
example of a T command string : 

T i_,DT1i_i F I LEA<-DT2i_j SOURCE u-i ( AQT ) J 
NOTE 

The Q switch cannot be used to modify the 
contents of files which have been previ- 
ously modified by the use of either or both 
the (C) and (T) switches since the contents 
would no longer be in a card format. 


3.5.7 (T) Switch: Delete Trailing Spaces 


The (T) option switch may be added to transfer commands used to input 
data from a card reader or to transfer files containing data in a 
punched card format (i.e., 80-character ASCII data groups). The use 
of the (T) switch causes PIP to locate and insert a RETURN [J) charac- 
ter immediately after the last non-blank character in each file (or 
input) card-format data group. The (T) switch thus deletes the trail- 
ing spaces which result from inputting the unused portions of the ongi 
nal punched card sources. 
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3.5.8 (V) Switch: Vertical Forms Control on Output 


The (V) options switch may be added to transfer commands to translate the 
first character of each record to a special character which, when inter- 
preted by the line printer (LP) handler, the terminal handler (TT) or 
by the VP15A handler (VP) will produce forms control functions. The 
translation will occur according to the FORTRAN conventions shown below: 


Character Found 

Translated To 

Meaning to LP Handler 

•1' 

FF, 14g 

Ship to top of form 


DLE , 20 g 

Overprint 

'O' 

DC1 , 21g 

Double space 

anything else 

LF, 12 g 

Single space 


If, for example, a FORTRAN program writes a listing file to disk rather 
than to the line printer (which might be temporarily out of service) , 
the file may be transferred at a later time to the printer as follows: 

•+T LP-*-DK .TM0T0 OTS (AV) J 

3.6 V: VERIFY OPERATION 


IOPS ASCII or Binary files may be checked for parity and checksum errors 
by using the PIP Verify V operation. 


Data mode switches (A) IOPS ASCII and (B) IOPS Binary are the only 
optional PIP switches permitted with V operations. 


The Verification command string requires: 

a) the V operation control character; 

b) the mnemonic of the device containing the file to 
be examined; 

c) the filename and extension of the file being checked; 

d) data mode switch (A) or (B) . As in the T command, 
the mode switches may be dropped if the extensions 
SRC or BIN are used; conversely, these extensions 
may be dropped when the mode switches are indicated. 
A 3-character extension where the last character . 

is numeric also defaults (A) . Note that in multiple 
file verifications, all files must be of the same 
data mode (i.e. , all IOPS ASCII or all IOPS Binary). 
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COMMAND STRING EXAMPLES: 

a) the command: 

DK ujF I LEA ( A ) J 

will verify the file FILEA SRC listed in the UFD of 
the current user (UIC) . 

b) the command: 

VuPRuifBjJ 

verifies the contents of an IOPS Binary paper 
tape mounted in the paper tape reader. 

c) the command: 

V,_, DT 3 i_jF I LE A , F I LEB , F I LE C i_j ( A )J 
verifies three ASCII files contained on DECtape unit 3. 

If either a parity or a checksum error is detected during a Verify 
operation, the message: 


"PARITY ERR" 

OIT 

"CHKSUM ERR" 

is output at the console printer by PIP. 

A Verify, V, operation is interrupted only for the printing of error 
messages, it continues the verify operation until the entire file has 
been examined. 


During verification of IOPS ASCII files (mode (A) ) the line containing 
each detected error is printed at the console printer immediately after 
the error message printout. The following is an actual example of the 
error message/error line printout obtained during the verification of 
an ASCII file. 


V PR (A) 

PARITY ERROR 

START W0 

PARITY ERROR 

JMP TE 

PARITY ERROR / 

@ - 1 

PARITY ERROR 

TELP 0 ' 


Lines in the file which 
contain a detected error 
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Read Section 3.5.1 for a method of correcting lines with parity errors 
in IOPS ASCII files. 

3.7 S: SEGMENT FILE OPERATION 

PIP provides commands which enable a single IOPS ASCII file located on 
either a directoried device (e.g., DT, DK, DP, RK, MUT) or a paper tape 
to be segmented into, up to 16 individual files or tapes. The PIP 
segmentation operation is initiated by an S (segment file) command fol- 
lowed immediately by a T (transfer) command containing a (Y) option 
switch. 


NOTE 

The (Y) switch may only be used with data 
mode switch (A) , (IOPS ASCII) . 

3.7.1 S, Segment File Command 

The S command enables the user to specify up to 16 "segmentation 
points" within a file that is to be segmented. 

A segmentation point is defined as a group of from 1 to 5 characters 
which identify a specific line within a file. The characters of a 
segmentation point must appear in the FIRST five character positions 
of a line. 

Each segmentation point indicates to PIP that all lines of the file 
from the beginning of the file or the preceding segmentation point, 
up to but not including the current segmentation point, are to be 
transferred as a single file. 

The format of the S command string is as follows: 

Si_jSEGl , SEG2 , . . . , SEG15 ,SEG16 

As shown above, commas must be used as delimiters between the specified 
segmentation points. 

3.7.2 T Command Requirements for S Operations 

The T command used in file segmentation operations must: 
a) contain a (Y) switch; 
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b) name a corresponding destination file for each seg- 
ment of the source file; 


NOTE 

The number of destination filenames re- 
quired in a T command is equal to the 
number of S command segmentation points 
plus 1. 


c) contain the source device mnemonic and source file- 
names and extensions. 

d) immediately follow the S command. 


During S operations: 


a) PIP examines the file line-by-line for the segmenta- 
tion points specified in the S command. 

b) As each segmentation point is found, PIP appends the 
.EOT pseudo-op to the defined segment and transfers 
it to the corresponding destination file. 


Assuming the following file present in the current UFD: 



.TITLE 

EXAMP 


.IODEV 

i ,2 

begin 

. I NI T 1 

, 1 .BEGIN 


.ENTER 

1 .FILNAM 

TAG 

.WRITE 

1 , 2 , BUF , 3 4 


.CLOSE 

1 


.EXIT 


FUF 

L 1 - . /2* 

1000+2; 0 


.ASCII 

’ HEJ ! '<1 75> 

L. 1 - - 
FILNAM 

.SIXRT 

’DTIO DAT' 


.END REGIN 


.EOT 



the manner in which file EXAMP may be divided into three segments, 
with each segment a separate named file, is shown in the following 
example: 


>S BEGIN, TAG 


SEGMENTATION S AND T 
COMMANDS 


>T DK PARTA .PARTB .PARTC ( A Y ) <-D K SEGEX SRC 

tP 

tP 

tP 

TP 
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>L TTVDK 


LIST CURRENT UFD 


24-N0V-75 

DIRECTORY LISTING (GEP) 


1510 

FREE 

BLKS 


4 

USER 

FILES 


4 

USER 

BLKS 


PARTA 

SRC 

1 

2 4- NOV- 75 

PARTB 

SRC 

1 

2 4- NOV- 75 

PARTC 

SRC 

1 

2 h- NOV- 75 

SEGEX 

SRC 

1 

04 - NOV- 75 


>1 TT<-DK PARTA (A) 


LIST SEGMENT A 


.TITLE EXAMP 
. 1 GDEV 1,2 
.EOT 


>1 TT«-DK PARTB (A) 


LIST SEGMENT B 


BEGIN .INIT 1,1, BEGIN 

.ENTER l.FILNAM 
.EOT 


>T TT<-1)K PARTC (A) 


LIST SEGMENT C 


TAG 

.WRITE 1 , 2 , BUE, 34 


.CLOSE 1 


.EXIT 

BIJF 

L 1 - . /2* 1 000+2; 0 


.ASCII ' HEJ ! 1 < 1 7 5> 

L 1 - • 
EILNAM 

. SIXBT ' DTI 0 DAT’ 


.END BEGIN 


.EOT 
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3.7.3 Source File to Multiple Paper Tapes Segmentation Operations 

The segmentation of a file and the outputting of each segment onto sep- 
arate paper tapes is performed in a manner similar to that described 
in Sections 3.7.1 and 3.7.2. The use and format of the S command is 
the same, but the T command differs as follows: 


No destination filenames need be used in the T command; 
however, a series of commas must then be used to indi- 
cate the number of paper tapes required. 

For example, the commands needed to segment file EXAMP (refer to pre- 
vious example), onto 3 paper tapes are: 

>S BEGIN ,TAG^ 

>T i _jPP l _i , ,|_j (Y) +-DKu_iEXAMPl_iSRCV 


The operations performed by PIP when outputting file segments onto 
paper tape are similar to those described in Section 3.7.2. 


When a file is segmented and the segments are output onto paper tapes: 


1) An .EOT pseudo-operation is appended to the end of 
each segment except for the last. 

2) With the exception of the last output tape, PIP 
pauses after each segment tape has been punched 
and causes a tP (CTRL P) message to be printed 
at the console printer. The pause permits the 
user to remove each tape before the next one is 
punched. 

3) The user must enter CTRL P (tP) to continue the 
segmentation operation after each pause. 

41 When the last tape is punched, control is returned 
to PIP from the segmentation operation. 


3.8 D: DELETE FILE OPERATION 


The Delete operation enables the user to delete files from user direc 
tories. The basic command format is: 

>D u device containing f ile (s) u f ilenameQextension ^ 

for example: 

>D,J3K U FILEA U SRC ) 
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More than one filename may be listed in a D command; however, they 
must be separated by commas. For example: 


> D uDK ljF ILEA^jS RC , F I LEBujS RC , F I LEC i_iS RC ) 


NOTE 

The complete name (filename and extension) of 
the file(s) must be specified exactly as entered 
in the directory from which they are to be de- 
leted. If more than one file in a directory has 
the same name, PIP will delete the first file of 
the specified name which it finds. 


One option switch, (X) , is permitted in the Delete command. This switch 
deletes all truncated files from the current or a specified (unprotected) 
UFD. The following are examples of the use of the (X) switch: 

a) >D. .DK. .(X)J for current UFD; 

b) >D. .DK. .<AAA> . ,<X)J for specified UFD. 

3.8.1 Deletion of Files from UFD's 

When a file is deleted from a UFD, its entry is removed from the user 
directory and the quantities given in the Directory listings (i.e., 

FREE BLKS , USER BLKS and USER FILES) are adjusted to reflect the de- 
letion. 


Files are deleted from the current UFD by using the basic D command. 
For example, assuming the following directory as current: 


2, b - MO V- 75 

DIRECTORY LISTING (JAN) 

5751 FREE BLKS 
2 USER FILES 
1 1 USER BLKS 

TEST! 001 10 C 4- MOV- 75 

MIN SRC 1 2 4- MOV- 75 


the command 


>D uj DK l _iTEST1 



results in the deletion of the file "TEST1 001" as illustrated in the 
following listing of JAN: 


3-34 



PIP Operations, Detailed Descriptions and Examples of Use 


2 4- MOV- 75 

DIRECTOPY LISTING (JAN) 

5761 FREE BLKS 

1 USER FILES 

1 USER BLKS 

MIN SRC 1 2 4- MOV- 75 


More than one file may be deleted from a directory during a D opera- 
tion. The deletion of four files by a single D command is shown in 
the following: 


>L TT-DK 


24- NOV- 75 


DIRECTORY LISTING (GEP) 


2251 

FREE 

BLKS 


10 

USER 

FILES 


10 

USER 

BLKS 


SEGB 

SRC 

1 

2 4- NOV- 75 

sesa 

SRC 

1 

2 4- NOV- 75 

EXAMP 

SRC 

1 

2 4- MOV- 75 

TTYFL 

SRC 

1 

2 4- NOV- 75 

PARTA 

SRC 

t 

2 4- NOV- 75 

TTYFLB 

SRC 

1 

2 4- NOV- 75 

PARTB 

SRC 

1 

p. /| - no V- 75 

PARTC 

SRC 

1 

2 4- MOV- 75 


Original VFD 


> D DK SEGB SRC, SEGA SRC, TTYFL SRC, TTYFLB SRC Delete Command 


>LTT«-DK 


24 -MOV- 75 

DIRECTORY LISTING 
2255 FREE BLKS 
4 USER FILES 
4 USER BLKS 
EXAMP SRC 1 

PARTA SRC 1 

PARTB SRC 1 

PARTC SRC ! 


(GEP) 


P./- NOV-75 
o / - v n y - 7 ^ 

2 A -NOV- 75 
MOV- 75 


Revised VFD 


NOTE 

The protection code assigned each individual 
file is overridden by the UFD protection code. 
If the UFD is unprotected (code 0) any file it 
contains may be deleted by other users of the 
system regardless of the protection code of 
the individual file. 
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3.8.2 Deletion of DECtape Files 

When a file is deleted from a DECtape directory, all references to the 
file are removed from the directory and the File Bit Map blocks. 

The command format is the same as that described for the basic operation. 
For example, to delete a file from device DTI, use the command: 

>D. .DTI, .filename, .extension^ 


D will also delete (that is make inactive) files on magtape. 


3.8.3 (X) Switch: Deletion of Truncated Files 


The use of the (X) optional switch in a "D" command deletes all truncated 
files contained by the current UFD or any specified non-current UFD 
(unprotected) . For example, assuming the following UFD as being current: 

2 4- NCU-75 

DIRECTORY LISTING ( GEP) 

5372 FREE BLKS 

2 USER FILES 

3 USER BLKS 

SEGEX SRC 3 2 4- MOV- 75 

.TFIL1 EDT* 0 p/s-M 0V-75 

the command : 


>D,_jDK|_| (X)J 


causes the truncated file " . TFIL1 EDT*" to be deleted from the UFD. 
The resulting UFD appears as: 

2 \) 0 \ l - 75 

DIRECTORY LISTING (GEP) 

5436 FREE BLKS 
1 USER FILES 
3 USER BLKS 

SEGEX SRC 3 p/i-^nV-75 

3.9 R: FILE RENAME OPERATION 


The PIP R operation enables the system user to: 


a) Change filenames within current UFD's, specified 
UFD 1 s and DECtape and magtape directories; 
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b) change the protection code for the current or speci- 
fied UFD's; 

c) change the protection codes of files within the cur- 
rent or specified UFD's. 


The basic format for the R command is : 


R directory device new name ext directory device old name ext 

The "directory device" must be the same on both sides of the backarrow 
(■*-) . This is the device which contains the file to be operated upon 
by the R command. 


3.9.1 Renaming Files 


Files within the current UFD or located in DECtape directories may be 
renamed using the basic R command. For example, assuming the following 
UFD to be current: 

2 -3 -NOV- 75 

DIRECTORY LISTING C GEP) 

5436 FREE BLKS 
1 USER FILES 
3 USER BLKS 

XMPLE SRC 3 f!4-\’PV-75 


The filename "XMPLE" is changed to "SEGEX" by the following: 


> R DK SEGEX SRC <-DK XMPLE SRC 

>L TT«-DK 

?, 4 -NOV- 75 

DIRECTORY LISTING (GEP) 

5436 FREE BLKS 
1 USER FILES 
3 USER BLKS 

SEGEX SRC 3 " >■- " r "J- 75 




Note that the file creation date also changes. 

Truncated files cannot be renamed. If an attempt is made to do so, 
an IOPS 10 error results. 

Files on DECtape and magtape are renamed using the same command format 
as shown for disk (UFD) files. 
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3.9.2 Setting File Protection Codes 

R commands may be used to change both the name and protection codes 
for disk files. The format for this function is: 


>R|_jdevicejjnew name Li ext-‘-device u old name u ext u (#) ) 

where (#) is the specified file protection code (see Section 2.3.7 for 
codes) . 

For example, assume that the revised UFD of the preceding example is 
still current, the file protection code of file "SEGEX SRC" is changed 
from 2 to 1 in the following manner: 


>R DK SEGEX 1 SRC«-DK SEGEX SRC (1) 


R command 


>L TT-DK (P) 

p /\- \>ov_ 75 

DIRECTORY LISTING < GEP) 

5 436 FREE BLKS 
1 USER FILES 
3 USER BLKS 

SEGEX1 SRC 2201(1) 3 24-N0V-75 2205 


-\ 




74 


UFD listing 
showing new 
file protec- 
tion code and 
new file names. 


3.9.3 Setting Directory Protection Codes 

R commands may specify a new protection code for the current or a 
specified UFD. The following command format is required for this 
function. 


>R u disk L f XXX: Z> ) 


where : 

1) XXX is the 3 -character UIC of the UFD involved 

2) : is the required delimiter for this function 
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3) Z is the protection code to be assigned to the 
specified UFD: 0 = unprotected; 1 = protected. 


For example: 


>L TTVDK CM) 


?. 4 -MOV- 75 

MFD DIRECTORY LISTING 
2255 FREE BLKS 
43 USER FILES 
515 USER BLKS 



J 


Origina l 
MFD indicates 
that no un- 
protected 
UFD ' s are 
in the system 


>R DK < GEP :0> 


>L TT«-DK CM) 


P.4-N0V-75 '' 

MFD DIRECTORY LISTING 
2255 FREE BLKS 
43 USER FILES 
515 USER BLKS 
GEP 1003(0) 4 4 


Revised MFD 
showing the 
unprotected 
UFD "GEP" 


The standard protection rules apply here: a user cannot change the 
protection code of a UFD that is protected if that UFD is not current. 
Note, however, that a non-current unprotected UFD can be changed to 
protected and thus become unaccessible to the renaming user. 

3.10 B: BLOCK COPY OPERATION 

The PIP B operation enables the user to copy the contents of selected 
storage blocks or ranges of blocks from one device into specified 
blocks of another similarly structured device. For this operation 
the user must specify: 

1) the destination device and the storage blocks which 
are to receive the copied information, 

2) the source device and the specific blocks which are 
to be copied. 

The command format required is: 

>BLjDest.Dev.uList of Rec. Blocks-<-Source Dev.^List of Blocks to be copied^? 


The blocks to receive data and those which are to be copied are identi- 
fied by their respective octal numbers. 
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A series of non-consecutive blocks (either source or destination) is 
specified by listing their octal numbers, in sequence, separated by 
commas (required delimiter) . For example: 

>BJDT1 U 50,55,60^DT2 Q 101,107,2 00 ) 

specifies that the contents of blocks 101, 107 and 200 on DT2 are 
to be copied into blocks 50, 55, and 60 of DTI (i.e., 101 to 50, 

107 to 55, and 200 to 60). 


A series of consecutive blocks (either source or destination) may 
be specified as a range of numbers. The range is specified by list- 
ing the first and last block numbers of the series separated by a 
dash (-) , the required delimiter. For example: 

>BJDT1 U 50-55^DT2 U 100-105 ) 

specifies that blocks 100, 101, 102, 103, 104 and 105 of DT2 are to 
be copied into blocks 50, 51, 52, 53, 54 and 55 of DTI. 


When data is to be copied from and written into the same blocks on 
both source and destination devices, only one set of block numbers 
is required. For example: 

^uPTljjl , 3-5+-DT2 ) 

and 

>B a DTlf-DT2 u l, 3-5 ) 

specify that blocks 1, 3, 4 and 5 are to be copied from DT2 into blocks 
1, 3, 4 and 5 of DTI. 


UIC block copy operations are permitted between the following devices: 

a) Disk Area to DECtape permitted for the UIC user. 

b) DECtape to DECtape permitted for any system user. 

Option switches (N) and (S) may 
be included in B commands for 
this type of operation. 


In all block copy operations, the data transferred (copied) is auto- 
matically verified. 
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3.11 C: COPY MASS STORAGE OPERATION 


The PIP C operation provides the system user with the ability to: 


a) add the contents of one device to that of another device 

b) copy the complete contents of one directoried device 
onto another similarly-structured device. 


The format for the C command is : 


>C|_jdestination device-*- source 


device 


; 


The following option switches may be added to the C command: 


a) (N) New Directory switch 

Permits destination device directory to be initialized 
during C operation. Note that this switch is illegal 
to magtape. 

b) (S) Initialize with QAREA switch 

Initializes the directory of the destination DECtape and 
establishes a QAREA on the tape prior to the copy 
operation. 

c) (H) Image Mode switch 

H mode copy is a total replacement operation in that 
each block on the destination device is replaced by 
the corresponding block of the source device. This 
form of copy, therefore, may be used only between 
the following like devices: RK to RK, DP to DP, DT 
to DT; it is most useful for copying DECtapes . As 
each block is written onto the destination device, 
a word-by-word comparison is made between the desti- 
nation block and source block to ensure accuracy. 

If an error occurs, the number of the block containing 
the error is output on the console printer and the 
copy continues. Once the copy operation is complete 
the blocks which contain errors may then be recopied 
using the Block Copy (B) function; this eliminates 
having to repeat the entire device copy operation. 

All available free core is used during H Mode Copy 
operations; the more core that is available the 
faster the copy operation. It is therefore advanta- 
geous, prior to calling PIP, to assign only those 
handlers needed for the copy operation using the A 
(Assign) monitor command. For example, the fastest 
possible copy operation between DECtapes is achieved 
by assigning handler DTE to all positive .DAT slots. 
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3.11.1 Adding Files, Copy Operation 


The use of the basic C command results in files being copied from the 
source device and added to the contents of the destination device. 

For example, the command: 

>Ci_|DTr<-DT2y 

causes the files on DT2 to be added to the contents of DTI. Truncated 
files on the disk are not transferred during a copy. The basic copy 
(i.e., add-on) operation is permitted between: 


DEVICES 


OPERATION PERFORMED 


a) Tape to Disk 


b) Disk to Tape 


integrates all DECtape or mag- 
tape files into the current UFD. 

A typical command is : 

> C l _,DK|__,- < - DT 1 

integrates all files contained by the 
current UFD onto the specified mag- 
tape or DECtape. A typical command 
is : 


>Ci_|DTl+-DK^ 


c) UFD to UFD copy operations (i.e., the integra- 

tion of files) may be carried out 
between the current UFD and an unpro- 
tected UFD. For example, the com- 
mand : 

>c,_ 1 dk lj <jan>+dkJ 

adds the files of the current UFD 
to the UFD "JAN". 

Copy operations may also be per- 
formed between the current UFD and 
a protected UFD; however, truncated 
files and files with a protection 
code of 3 are not copied. 

d) DECtape to DECtape integrates all files from the source 

device onto the destination device. 

A typical command is: 

>Cl_,DT1-*- DT2 J 


NOTE 

If the destination device cannot 
store all of the input files, all 
possible files are copied and an er- 
ror message printed at the console 
teleprinter . 
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Assuming a current UFD containing the file "XMPLED SCR", the following 
is an example of a basic copy (i.e., C) operation: 


2^4- NOV-75 

DIRECTORY LISTING 
1066 FREE BLKS 
1 USER FILES 
10 SYSTEM BLKS 
EOTST SRC 1 



DT0 DIRECTORY BEFORE 
COPY OPERATION 


>C L pTQ+DK) 


C 4- \'0V- 75 

DIRECTORY LISTING 
1062 FREE 8LKS 

2 USER FILES / 

10 SYSTEM BLKS 

EDTST SRC 1 2 

XMPLED SRC 2 4 „ 

A technical note on the copy command: 

mode regardless of the true mode of t 


COPY CONTENTS OF CURRENT 
UFD ONTO DT0 

DT0 DIRECTORY AFTER 
COPY OPERATION 

all transfers are done in Dump 
file. Therefore, PIP can trans- 


fer, under one copy command, files of different data modes. 


3.11.2 Copy with Directory Initialization 

Switches (N) and (S) may be added to C commands to initialize the dir- 
ectory of the destination device (illegal to magtape) . 

The (N) switch is used in the following manner: 


a) Copy to System Device When added to a basic C com- 

Operations mand, the (N) switch either 

initializes the UFD for the 
current or specified UIC or, 
if no UFD exists, creates a 
new UFD. 

For example, the command: 

>Ci_jDK< JAN>i_j(N)-«-DTV 

first initializes the UFD for 
UIC "JAN" or, if none exists 
creates one. Then the files 
contained by DTl are incorpo- 
rated into the UFD for "JAN" . 

b) DECtape to DECtape copy When added to a DECtape to 

DECtape C command, the (N) switch 
initializes the directory of the 
destination device before the 
copy operation is carried out. 
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The (S) switch is permitted only for DECtape copy operations. This 
switch initializes the directory of the destination DECtape and 
establishes a QAREA on the tape prior to the copy operation. 

When the (S) switch is used alone, the + QAREA reserved on the initial- 
ized device has the same size as the core available in the system. 

For example, the command: 

>C U DT1 U (SKDT2 ) 

will: 

a) initialize the directory of DTI, 

b) reserve a +QAREA on DTI equivalent in size to the 
core contained by the system, 

c) copy the contents of DT2 onto DTI. 

Two digits may be added to the (S) switch (i.e., (Snn) to indicate in 
4K (i.e., 4096-word) units the size of the + QAREA to be reserved). 

This size is normally specified in 8K units starting at 24K (minimum 
XVM/DOS core requirement). For example, the command: 

>CyDTl L j(S32) -f-DT2 ) 

initializes the directory on DTI, causes a 32K iQAREA to be reserved 
on DTI and copies the contents of DT2 onto DTI. 

3.12 U: UPDATE STORAGE ALLOCATION TABLES OPERATION 

It is possible for areas on disk devices to be faulty or damaged 
in such a manner that they cannot be read from or written on. 

When a faulty area is detected, the Monitor outputs an error 
message which describes the condition and lists the block number of 
the bad area. 

On the detection of faulty read/write disk areas, the current user 
must delete the current file where the error was indicated, then 
utilize the PIP UPDATE operation to: 

a) Cause the system Storage Allocation Table (SAT) 

to be updated to reflect the removal of the faulty 
blocks from "available storage". 
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b) Update the system Bad Allocation Table (BAT) with 
the numbers of the detected faulty blocks. If no 
BAT exists, the table is created by the update op- 
eration. 


The command string format for a PIP U operation is : 

>U|_|DK l _ J N>) 


where N may: 


a) be the octal number of one faulty block or a series 

of numbers identifying a list of non-sequential faulty 
blocks. 

For example, the command: 

>Ui__,DKi_, 101- 10^5 , 115y) 

updates the BAT and SAT to indicate that disk stor- 
age blocks 101-105 and 115 are faulty. 

b) Indicate a range of numbers which describes a series 
of continguous blocks which are found to be faulty. 

For example, the command: 

>U uj DK l _,101-105>) 

updates the BAT and SAT to indicate that disk stor- 
age blocks 101 through 105 are faulty. 


On completion of each UPDATE operation, PIP outputs the message 


n BAD BLOCKS IN SYSTEM 

on the console printer. The letter "n" represents an octal number 
which indicates the total number of bad blocks on the disk. 


3-45 






CHAPTER 4 

MIC PIP OPERATIONS 


4.1 GENERAL PIP MIC OPERATIONS 


The system manager, when logged in under the Monitor Identification 
Code (MIC) , can perform all of the operations described in Chapter 3 
He is required to specify only the UFD or device involved. For ex- 
ample, to transfer a file between UFD's the MIC enters a command sim 
ilar to the following: 

>T l _jDKi_j<JAN>i_jDESTFL^DKi_j<GEP>i_jSOURCEi_j(A) y ^ 

If a UFD is not specified, PAG (for page mode systems) or BNK (for 
bank mode systems is used. 

Protection codes, file or UFD, do not apply to the MIC. 

4.2 SPECIFIC MIC FUNCTIONS 

The following paragraphs describe PIP operations which are unique to 
the MIC or give different results to the MIC user. 


4.2.1 N Operation 


The MIC user may initialize any user UFD or DECtape directory in the 
system by specifying the directory's UIC or device/unit mnemonic in 
the command. For example: 

a) >N|_,DKi__i< JAN J 

clears all files from the UFD identified by the UIC "JAN". 

b) >N,_jDTlJ 

clears the directory of DECtape unit #1. 

WARNING 

The command " N DK " issued by the MIC, 
initializes either the PAG (page mode) or 
BNK (bank mode) system UFDs. If either of 
these UFD's is initialized, critical sys- 
tem programs are lost which must be re- 
stored for successful operation. 
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4.2.2 L, List Directory Operation 


The only difference between the UIC and MIC "L" operations is that in 
listing the MFD, the MIC user obtains a complete listing of all UFD's 
in the system, regardless of their respective protection codes. 


For example, the listing obtained by the command: 
> L^LP-t-DK (M)y 
a) by a standard user (UIC) - 


r> i;- NOV- 75 

MFD DIRECTORY LISTING 
5766 FREE RLKS 
52 USER FILES 
641 USER BLKS 


b) by the MIC - 


24- NOV-75 

MFD DIRECTORY LISTING 
5766 FREE BLKS 
52 USER FILES 


641 

USER BLKS 



RNK 

1000( 1 ) 

5 

1 57 

PAG 

1001(1) 

5 

160 

IOS 

1002(1 ) 

30 

247 

SCR 

NO N ( 1 ) 

0 

0 

WAD 

1240(1) 

1 

4 

JAN 

1566(1) 

1 

1 

TMP 

1573(1 ) 

6 

26 

GEP 

NON ( 1 ) 

0 

0 


4.2.3 Delete Truncated Files from System 


A Delete command with an (X) option switch issued by the MIC will de- 
lete all truncated files from all UFD's contained by the operating 
system. The command required is: 

>D^_,DK i_,(X) V 


4.2.4 I, Initialize Operation 

The use of this operation clears all of the device bit maps and initial 
izes the MFD. Initialization of the MFD sets it to a default state. 

The contents of the disk are lost. This command is most useful for 


4-2 



MIC PIP Operations 


initialization of disk packs. The form of the command is: 


>i opiy 
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CHAPTER 5 


PIP ERROR DETECTION PROCEDURES AND MESSAGES 

5 . 1 INTRODUCTION 

This Chapter describes the error detection, reporting and corrective 
procedures employed in PIP operations. Only the error messages and 
procedures output and followed by the PIP program are described. A 
complete list of system error messages (IOPS) is given in Appendix D. 

PIP error detection and reporting operations are concerned primarily 
with: 

a) the detection of errors in the user command string, 

b) the detection of errors during the performance of 
the user-requested operation. 


5.1.1 User Command String Errors 


When each input command string is terminated, PIP immediately scans 
the entered string for such items as : 

a) format errors, 

b) error in function requested, 

c) Conflicts in requested function, 

d) completeness of information. 


Errors in the command string are normally handled in the following 
manner : 

a) a message identifying the error found is printed on the 
console teleprinter, 

b) the command string entered is retyped by PIP, on a separate 
line up to the point where the error was detected. PIP 
outputs a question mark (?) at the point of the error, 

c) the user may enter CTRL P or carriage return to abort the 
operation or may complete the command string from the ? 
symbol on, entering the needed correct information. Note 
that it is not necessary to type a space after the ? 

Example : 
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T DK7PILE SRODTlJ 

The latter should initiate the requested operation if no 
further error exists. 


EXAMPLE: the following is an example of the detection, reporting 

and correction of a command string error: 


L TT«-<WCK> 

ILLEGAL DFVICE OR UNIT 

,L TT*-?J3K <WCK> | 

PIP reprint to Error Point (?) 


Command String Entry 
Error Message 


Corrections entered by User 


In the above example, the user forgot to enter a source device mnemonic 
(i.e. , DK) . PIP detected the error, output an error message and that 
part of the command line up to the error (i.e., >L|__|TT<-? ) ; the user 
chose to complete the operation and entered the needed data (i.e., 
DK<WCK>) to complete the string and initiate the desired operation. 


NOTE 

In correcting errors involving a source 
filename, it is necessary to respecify 
the file data mode. 

5.1.2 Operational Errors 

PIP also detects and reports errors found during the performance of 
the requested function. Parity errors, checksum errors, the inability 
of PIP to find a referenced filename, and protection code violations 
fall into this category. These errors are reported by PIP by messages 
output on the console teleprinter. The following is an example of an 
operational error: 


>T RX <GEP> EXA^m FPC«-FP} 

parity pprop 



An error 
tape 


Command 


was detected 


on 


the input 


PIP restarts itself after outputting the error message. 


5.2 PIP ERROR MESSAGES 

The messages output by PIP on the detection of command string or opera- 
tional errors are listed and described in Table 5-1. 
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Table 5-1 

PIP Error Messages 



Printed Messaqe 

Interpretation 

1) 

CHKSUM ERR 

An error has occurred in the transfer of data; retry 
transfer. 

2) 

COMMAND STRING TOO LONG 

The command string entered exceeds 72 characters. 

3) 

DATA MODE MISMATCH 

The data mode derived from the command string does not 
match the mode specified in bits 14-17 of the first header 
word. The transfer is aborted. 

4) 

DEV ILL FOR OPTION FUNCTION 

Change function or device. Retype from error. 

5) 

DEVICE NOT IN +. DAT 

Return to the monitor and use the A (Assign) command to 
assign the device involved to any positive .DAT slot. 

6) 

DISK FULL 

Device has no further storage available. 

7) 

FILE ALREADY PRESENT 

There is already a file present under the new file name 
and extension supplied in a ' R* function. The operation 
is aborted. 

8) 

FILE NAME TOO LONG 

Filenames are restricted to a maximum of 6 characters plus 
a 3-character extension: the user has exceeded this limit. 
Retype from error. 

9) 

FILE NOT ON INPUT DEVICE 

There is no file under the specified name on the direc- 
toried input device. Retype from error. 

10) 

FILE STRUCTURE CONTAMINATED 

The file structure on the device (i.e., disk) is faulty; 
this error indicates that the system bit map(s) is (are) 
incorrect . 

11) 

ILL BLK # 

Improper block number (i.e., too large, or negative) 
specified in command. Retype command. 

12) 

ILL CMD STRUCTURE 

The command string entered was not properly ordered or 
structured. Retype the correct command. 
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ILL CNT 


ILL DEV/UNIT 

ILL FUNCTION 

ILL FUNCTION FOR UIC 

ILL P CODE 

ILL SWITCH 

ILL TERMINATOR 

20) ILL UFD ENTRY SIZE 
OR 

ILL MFD ENTRY SIZE 


Table 5-1 (Cont) 
PIP Error Messages 


Interpretation 


This error message is printed only in DECtape Directory 
listings. When output, it will appear immediately after 
the directory line "SYSTEM BLKS" (for example: 0 SYSTEM 
BLKS ILL CNT) . This message indicates that an illegal 
number of system blocks have been detected. The user, on 
detection of this error message, should immediately attempt 
to transfer any files contained by the DECtape involved 
onto another DECtape. The files should be transferred 
one at a time. The faulty DECtape should be initialized 
to clear the error condition. 

Illegal device mnemonic specified in command string. 

Retype from error. 

The function specified in the command string entered (i.e., 
first character) is not a legal PIP function. Retype 
from error. 

The operation specified is not permitted at the level of 
the current user. For example, a standard user (UIC) can- 
not employ the (H) switch in a copy to system device opera- 
tion. The requested operation is not performed. 

Specified directory code is illegal (i.e., something other 
than 0 or 1) or the directory just read has an illegal 
protection code. Retype from error. 

An optional switch entered in the command is not permitted 
in the primary operation being performed. Retype from 
error. 

Command improperly terminated: only RETURN or ALT MODE is 
legal. Retype from error. 


The size of an entry (i.e., filename or UFD) in the dir- 
ectory involved is illegal. This error indicates that 
the system is faulty. 
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Table 5-1 (Cont) 
PIP Error Messages 



Printed Message 

Interpretation 

21) 

ILL UIC 

User has given an improper code; the UIC must be a 3- 
character code within angle brackets (i.e., <XXX>) . Retype 
from error. 

22) 

INPUT LINE TOO LONG 

Input commands are limited to one physical line of 72 
characters; the user has attempted to exceed this limitation. 

23) 

NEED BLK # 

No block number was given in an UPDATE command; enter re- 
quired octal number. 

24) 

NEED DATA MODE 

User must enter the proper data mode switch. Retype from 
error. 

25) 

NULL FILE NAME ILL 

A filename must be specified; a nullname is not acceptable. 
Retype from error. 

26) 

P VIOLATION 

Current user has attempted an operation which violates the 
established protection code of a UFD or a file. The opera- 
tion is aborted. 

27) 

PARITY ERR 

File being processed contains a parity error. During T, 
transfer operation, this message may be accompanied by a 
printout of the line which contains the error. The user 
must correct the indicated line (Use (G) switch in a 

Transfer, T, operation or the Editor) . 

28) 

READ-COMP ERROR ON BLK: XXXXX 

During H mode or Block (B) copy operations, PIP compares 
the newly written data blocks against the original blocks 
and outputs this message if they are different. The opera- 
tion goes to completion. 

29) 

S FUNCTION NOT DONE 

A segmentation operation requires the entry of an S command 
followed by a T command. This message indicates the S com- 
mand was not entered before the T command with the Y 
switch. 
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Table 5-1 (Cont) 
PIP Error Messages 



Printed Messaae 

Interpretation 

30) 

STRINGS 1-16 ACCEPTED 

If a Segment (S) operation divides a file into more than 

16 segments, PIP will load segments 1-15 to their re- 
spective destination files. All remaining segments are put 
into the 16th file and this message is printed. 

31) 

SWITCH CONFLICT 

Two or more switches entered in the command cannot be used 
together. Retype from error. 

32) 

SYSBLK NOT ON DEV 

Device specified is not the system device. The List opera- 
tion is aborted. 

33) 

TOO FEW FILES 

These error messages indicate that the number of files on 
the destination side of the command does not match the 

34) 

TOO MANY FILES 

number given on the source side. All matching files have 
been transferred; transfer the rest via a new command. 

35) 

TOO MANY FILES OR BLOCKS 

The limit of in either case was exceeded. Retype the 

command, giving 1 ^ or fewer block numbers of file names. 

36) 

UIC NOT IN MFD 

Indicates that a File Directory (UFD) has not been established 
for the current user. The user should employ the PIP N 
command to set up a UFD under his identification code (i.e., 
UIC) . 

37) 

WARNING - FILE HAS ILL P CODE 

This message indicates that the file last read has an 
illegal protection code. The requested operation will be 
carried out; however, an error message of this type indi- 
cates that the system is faulty, or that an illegal default 
protection code was specified at SGEN time. 


i 


I 


) 
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5.3 CORRECTION AND RECOVERY COMMANDS 


If a user detects an error in the command string before it is terminated, 
he may 

a) delete the incorrect character, 

b) negate the line entered (prior to terminator) 
and restart on a new line. 

If an error is detected in the user's command string by PIP, he may 

a) respond to the PIP error report and command string 
printout by correctly completing the command; 

b) abort the task by entering a CTRL P or RETURN. 

The commands which permit the above procedures are listed and described 
in Table 5-2. 


Table 5-2 

User Correction and Recovery Commands 

Which is Echoed on 
To: Type : the Teleprinter as : 

1) Delete a character from RUBCUT / 

the command string 

NOTE 

Characters are deleted one per entry start- 
ing from the last entered character and pro- 
ceeding to the left. 

2) Negate (delete) line CTRL U (? 

entered 

NOTF 

The CTRL U entry must be made before the 
line is terminated. 

3) Abort the current task CTRL P IP 

and/or return control to or 

PIP RETURN Nonprinting 


NOTE 

CTRL P entries are also requested by PIP 
during paper tape input and file segmenta- 
tion operations to continue operations after 
^ tape or file segment has been transferred. 

4) Abort the current task CTRL C tC 

and/or return control to 
the monitor 
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Table 5-2 (Cont) 

User Correction and Recovery Commands 




Which is Echoed on 

To ; 

Tvoe 

the Teleprinter as: 

5) Continue the requested 

operation after a "DEVICE 
NOT READY" condition has 
been corrected for a 

PDP-15 or XVM device (not 
needed for a UC15 device) . 

CTRL R 

tR 
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CHAPTER 6 


QUICK REFERENCE TABLES 


6.1 INTRODUCTION 

This Chapter contains tabularized data intended as an aid to recall for 
users who are familiar with the contents of Chapters 2 and 3. Tables 
are supplied which describe the Primary PIP Operations, PIP Optional 
operations, optional functions permitted within each primary operation, 
and the PIP command structure, plus a series of tables describing spec- 
ific operations which may be carried out using PIP facilities. In some 
cases, the tables presented in this section are duplicates of those 
contained in earlier sections of the manual; this redundancy is necessary 
to make this section a complete single source of information. 

6.2 OPTIONS VERSUS PRIMARY OPERATIONS 

The matrix Table 6-1 illustrates the optional PIP function switches 
permitted in each of the PIP primary operations. 

6.3 PIP COMMAND STRING FORMAT CHARTS 

Figure 6-1 illustrates the general format of the Destination/Source 
command strings; Figure 6-2 illustrates the general format of the 
Single-Device Command Strings. 

6.4 PIP USER OPERATION TABLES 

Tables 6-2, 6-3, 6-4, 6-5, and 6-6 describe the operations which may 
be performed by the standard user (UIC) ; they contain: 

a) a description of the operation, 

b) the optional switches which may be used, 

c) an example of a command string for each operation 
described . 
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No attempt is made to describe all possible operation/switch combina- 
tions or applications. However, the user is provided with sufficient 
commands to meet his own requirements if he has familiarized himself 
with Chapters 2 and 3 of this manual. 

The User Operation Tables are organized according to the following 
functional areas: 


Table Function Described 

6-2 Directory Operations , how to set up, list, modify, 

and operate with disk (UFD) and DECtape directories. 

6-3 List Operations , how to obtain printouts of direc- 

tory and file information. 

6-4 File Modification Operations , how to modify and 

manipulate files and file contents. 

6-5 File Transfer Operations , how to transfer files 

between system storage devices. 

6-6 Copy Operations , how to copy device contents, 

large groups of files or data blocks from system 
mass storage devices. 
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Table 6-1 

Available Options Versus Primary Operations 


PRIMARY OPERATIONS 



1 Legal only with DECtape, Disk Pack or Disk cartridge copy operations. 
2 Legal only when the current password is the MIC. 

transfer, T, commands which include a Y option switch must be imme- 
diately preceded by an S, segment command string. 


6-3 









































































T 


DK 


DESTFL l_i SRC i— : (G) <*— DTn 


DATA 


SRC ) 


OPERATION 

COMMAND DESTINATION DESTINATION FILE OPTION SOURCE SOURCE FILE 

CHARACTER 1 I DEVICE I I (filename | | ext) | I SWI TCH (S ) DEVICE I I (filename | | ext) TERMINATOR 






T = Transfer file 

L = List directory 

C = Copy mass 
storage 

R = Rename file 

B = Block copy 

Optional for non- 
file oriented de- 
vices. Use 
commas to sepa- 
rate multiple 
file names and 
extensions 

Use commas to 

separate mul- S= Return 

Liple file control 

names and ex- to PIP 

tensions. ALTMODE = 

Return 
control 
to the 

PP = Paper tape punch 

DTn= DECtape unit 

TT » Teletype 

LP = Line printer 

MTn— Magtape 

DK = DECdisk 

VP = VP15A CRT display 

PR = Paper tape reader monitor 

TT = Teletype 

CD = Card reader 

DTn= DECtape unit 

MTn= Magtape unit 

DK = DECdisk 

DPn= Diskpack unit 


DPn= Diskpack unit RKn= Disk cartridge unit 

RKn= Disk cartridge unit 


Data Mode Switches 


Function 


Switches 


A 

B 

I 

H 

D 


IOPS ASCII 
IOPS Binary 
Image Alpha- 
numeric 
Image Binary 
Dump 


E = Convert tabs to spaces 
G = Flag bad parity lines 
C = Convert multiple spaces to 
tabs 

W = Combine files 
Y = Segment files 
N = New Directory 
Snn = New directory with CTRL Q 
area. Size of area (nn) = 

8, 12, 16, 20, 24, 28, or 32 
(K words) N operation only. 

Default = current size of 
system. 

F = Insert Form Feed every 55. n 
lines or after .EJECT 

T = Delete trailing spaces Input must be 

Q = Delete sequence numbers j ^“format 
M = Request a listing of 
the system MFD 

L = Request a listing of the 
system SYSBLK directory 
P = Request UFD listing with 
RIB data 


Figure 6-1 Destination/Source Command String Format 


6-4 



Quick Reference Tables 


V 


DTI 


FILEA,FILEB 


(A) ) 


OPERATION 

COMMAND 

CHARACTER 


DEVICE 

MNEMONIC 


FILE (S ) INVOLVED 
Filename 1 — *Ext. 


OPTION 
SWITCH (S) 


TERMINATOR 







N=new directory 
V=verify file 
D=delete 
I=initialize 
U=update 

Use commas to separate 
multiple filenames and 
extensions. 

}=Return control 
to PIP 

ALT MODE = 
Return control 
to DOS 


PR=Paper Tape reader 

DTn=DECtape unit 

Monitor 


DPn=Diskpack unit 
MTn=Magtape unit 
RKn=Disk cartridge unit 


A = IOPS ASCII Data mode 
B = IOPS Binary Data Mode 
S = new directory with a core- 
sized +QAREA 

Snn = new directory with a 
user-specified sized 
1QAREA 

K = delete UFD 

X = delete all truncated files 


Figure 6-2 

PIP Single Device Commands, General Format 
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Table 6-2 

Directory Operations 


<T> 

I 

O' 


IN ORDER TO: 

11 Initialize the 
existing UFD or 
create a new UFD 
for the current 
UIC 

2j Initialize the 
existing UFD or 
create a new UFD 
for the current 
UIC during a T 
transfer 

3) Initialize or 
create a UFD 
for the current 
UIC with a speci- 
fied UFD protec- 
tion code 

4) Delete a file 
from the current 
UFD 

5) Rename a file in 
the current UFD 


6 ) Rename a file 
in the current 
UFD and set its 
protection code 

Change protec- 
tion code of the 
current UFD 


USE OPERATIONS: 
N, New directory 


T, Transfer 


N with code 
specified 


D, Delete 


R, Rename 


R , Rename 


AND OPTIONS: IN THIS MANNER; 

None >N U DK ) 


CN ) , (NA) , (NB) >T L jDK u pESTFL+-DTl u SOURCE u (NAl ) 


(None) 


None 


None 


None 


>N,jDK u (0) ) 


>D Q DK U DESTFL U BIN ) 

Note: Filename extension is required. 


>R u DK u NEWNAM u BIN^DK L pLDNAM L JBIN ) 

Note: Filename extension is required. 

>R Q DK u NEWNAM Ll BIN-*-DK L pLDNAM u BIN L1 (3) ) 


Note : 


Protection code is specified within 
parentheses . 


) 


7) 


R , Rename 


None 


>R u DKq< JOE : 0> ) 


Quick Reference Tables 




Table 6-2 (Cont) 
Directory Operations 



IN ORDER TO: 

USE OPERATIONS: 

AND OPTIONS; 

IN THIS MANNER: 


CO 
y— 1 

Initialize the 
directory of a 
directoried 
device 

N, New directory 

None 

>NuDTl ) 

Note: illegal to 

magtape 

91 

Initialize DEC- 
tape directory 
and set up a 
f QAREA of: 

N, New directory 





a) System core size 

(S) 

>N u DTl Li (S) ) 



b) Specified size 


(Snn) 

>NqDT1q(S3 2 ) ) 


105 

List contents of 
directories : 






a) MFD 

L, List 

(M) 

>LqTT-'-DK u (M) ) 



b) UFD 

L, List 

None 

>LqTT-<-DK ) Note: 

illegal from magtape 


c) DECtape 

L, List 

None 

>LqTTqDT1 ) 


id 

List contents of 
unprotected, non- 
current UFD 

L, List 

None 

>L q TT-«-DK u < JOE> ) 
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Table 6-3 
List Operations 


O' 

i 

00 



IN ORDER TO; 

USE OPERATIONS: 


11 

List the system 

MFD 

L, List 

(M) 

21 

List the UFD of 
the current UIC 

L, List 

None 

3] 

List the contents 
of an unprotected 
non-current UFD 

L, List 

None 

41 

List the system 
SFSBLK 

L, List 

(L) 

51 

List current UFD 
with File Protec- 
tion Codes and 

RIB information 

L, List 

CP) 

61 

List directories 
of DECtapes 

L, List 

None 

71 

List a selected 
file entry from 
the current UFD 
or device directory 

L, List 

None 

8) 

List a selected 
file entry from an 
unprotected non- 
current UFD 

L, List 

None 


noNs : 


IN THIS MANNER: 
>L,jLP<-DK u (M) ) 
>L u TT-*-DK ) 

>L u TT^DKu< JPE> ) 

>L U TT^DK U (L) ) 
>L U TT^DK U (P) ) 

>L u TT-<-DTl ) 

>L u TT u FILNAM L ^IN-f-DK ) 


>L u TT Q FILNAM L ^RC-<-DK t j: JOE> ) 
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Table 6-4 

File Modification Operations 



IN ORDER TO: 

USE OPERATION: 

AND OPTIONS: 

IN THIS MANNER: 

1) 

Rename a file 

R, Rename 

None 


>R u DK u NEWNAM u BIN-<-DKJDLDNAMJ3IN ) 

Note: Filename extension is required. 

21 

Rename and set 
the protection 

R , Rename 

None 


>R u DK,JJEWNAM l j t BINf-DK l _pLDNAM u BIN u (31 ) 


code for a file 




Note: Filename extension is required. 

31 

Delete a file: 






a) from current 






UFD 

D, Delete 

None 


>D U DK U FILEA U BIN ) 


bl from unpro- 




^yDKj: J0E>yF ILEAyBIN ) 


tec ted UFD 

D, Delete 

None 



cl from mass 




Note: Filename extension is required. 


storage de- 
vice directory 

D, Delete 

None 


>D L pTl u FILEA u BIN ) 

41 

Delete all trun- 
cated files from 
a UFD which is : 






a) current 

D, Delete 

(X) 


>D U DK U (X) ) 


bl specified 

D, Delete 

(X) 


^pDF^ ABC> U (X) ) 

5) 

Convert multiple 
spaces to tabs 

T, Transfer 

(C) , 

(CA) 

>T Li LPJDESTFL^DTl u SOURCE l _ 1 (CA) ) 

6 ) 

Convert tabs to 
spaces 

T, Transfer 

(E) , 

(EA) 

>T iJ LP l _pESTFL-‘-DTl LJ SOURCE u (EA) ) 

7) 

Detect and Correct 
File Parity and 
Checksum errors 

T, Transfer 

(G) , 

(GA) 

>t l /)K u destfl^dti i _^ource u (ga) ) 


81 

Delete Trailing 
Spaces from file 
contents 

T, Transfer 

(T) , 

(TA) 

^JDKyDESTFL^DTl^SOURCE^tTA) ) 


) 


! 
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Table 6-4 (Cont) 

File Modification Operations 



IN ORDER TO: 

USE OPERATION: 

AND OPTIONS : 

IN THIS MANNER: 

9] 

Delete sequence 
numbers from file 
(card input or 
card format data 
files only) 

T, Transfer 

(Q) , (QA) 

>T u DTl u pESTFL u 001 u (Q)-e-CD ) 

10) 

Combine separate 
files into one 
file 

T, Transfer 

(w) , (B) , (A) 

>T l _pTl u LIBR (J (WB ) ^012^ ILA^IN , F ILBJ3IN ) 

11). 

Segment a file 
into 2 to 16 
separate: 





a) files 

S, Segment + 

None 

> S U TAG , TAGB , TAGC ) 



T, Transfer 

(Y) , (YA) 

> TJDTl^ILA , FILB , F ILC , FILD U (YA ) -*-DT 2 u SOURCE ) 


b) papertapes 

S, Segment + 

None 

>S U TAGA, TAGB, TAGC ) 



T, Transfer 

(Y) , (YA) 

>T U PP U' ' ' i_i (YA) -‘"DTljjSOURCE ) 

12) 

Verify a file 
for parity and/or 
checksum errors 

V, Verify 

(A) , (B) 

> v 1 _Pk l1 f i l e a lj (a) ; 
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IN ORDER TO: 


USE OPERATION; 




11 Transfer a file 
to the current 
UFD 

2] Transfer a file 

to a selected non- 
current UFD when 
protection code 
permits 

3J Transfer a file 
from a current 
UFD to a specified, 
non-current unpro- 
tected UFD 

4J Transfer console 
keyboard entries, 
line-by-line, to 
a system output 
device 

5) Transfer file and: 

a) Convert spaces 
to tabs 

b) Convert tabs to 
spaces 

c) Enable parity 
or checksum 
error to be 
detected 


T, Transfer 

T, Transfer 

T, Transfer 

T, Transfer 

T, Transfer 
T, Transfer 

T, Transfer 
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Table 6-5 (Cont) 
File Transfer Operations 


IN ORDER TO: 

USE OPERATION: 

AND OPTIONS: 

IN THIS MANNER: 

d} Initialize the 
directory of a 
directoried 
device 

T, Transfer 

(N) or (NA) or (NB) 
Note: illegal to magtape 

>T u DTl | _pESTFL^-DT2 lJ S0URCE u (NA) ) 

el initialize or 
create a UFD 
for the current 
UIC 

T, Transfer 

(N) or (NA) or (NB) 
Note: illegal to magtape 

>tjdkjdestfl^dti lj source lj (na} ) 

f) Combine two or 
more files into 
one file 

T, Transfer 

(W) or (WA) or (WB) 

>T u DK L pESTFL^DT2 u A,B,C 1J (WA) ) 

g) Delete sequence 
numbers from card 
reader inputs 

T, Transfer 

(Q) or (QA) 

(QAC) 

(QAT) 

>t u dti u destfl u (qa)<-cd ) 
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Table 6-6 
COPY Operations 




IN ORDER TO: USE OPERATION: 


1) Copy the contents B, Block copy 

of a specific device 

storage block 

2) Copy the contents B, Block copy 

of a specific series 

(i.e., range) of 
device storage blocks 

3) Copy the contents 

of one or more blocks 
and : 


a) initialize the B, Block copy 

directory of the 
destination device 


b) initialize the B, Block copy 

DECtape direct- 
ory and reserve 
a f QSAVE area 
equal to core size 

cj initialize DEC- B, Block copy 
tape directory 
and specify size 
of +QSAVE area 
to be reserved 


4) Add (copy) the files C, Copy 
on one device to 
those of a second 
device 


5) Copy and add files 
from one device to 
another device and : 


RNT~) OPTIONS: 


None 


None 


(N) 


(S) 


(Snn) 


None 


IN THIS MANNER. 
>Bjm u 5^51-HDT2 u 101 f ljJ2 ; 

>B | ^Tl u 50-55-H3T2 L| ljJ0-ljJ5 ) 


> B U DT 1 u 5 0 - 5 5 ( N ) «- J) T 2 U 1 0 0 - 1 0 5 ) 


>BjjDTlm5 , 6 , 7 U (S ) ^DT2 U 50 ,51,52^ 


>B u DT1 u 5,6,7 u (S32)«-DT2 u 50,51,52 ) 


>C|_pK-*-DTl ) 


I 
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APPENDIX A 

USE OF VT15 GRAPHICS DISPLAY SYSTEM 


PIP users may employ the VT15 display unit as either a listing or a 
general purpose display device. 


PROCEDURE 


a) Before PIP is loaded, the command: 

$VT|__,ON J 

must be issued to the monitor to set up the display system for 
use. 

b) Once PIP is loaded, the user need only type CTRL X to activate 
the display function. For all practical purposes, the CTRL 

X {+ X) command causes the VT Display to take the place of the 
console printer unit. Command characters entered at the con- 
sole keyboard are echoed both by the console printer and on 
the VT Display screen; all other information normally output 
to the printer (i.e., error messages, listings, etc.) is dis- 
played on the VT display screen only. 

c) To discontinue the VT Display function, the user must issue a 
second CTRL X command. This action returns the display /print 
function to the console printer. The display unit, however, 
remains on and continues to display the information contained 
before the second CTRL X command was issued. 

d) To clear the VT15 Display screen, the user must actuate the 
rightmost display control pushbutton (see CONTROLS) and enter 
a RETURN at the keyboard. 

e) To turn the VT15 Display off (i.e., deactivate the CTRL X 
feature) the user must return control to the monitor (CTRL C) 
and enter the command: 

$VT|_jOFF jJ 


VT15 CONTROLS AND DISPLAY MODES 


CONTROLS 

The VT15 Display console contains a horizontal strip of six square 
push-to- light pushbuttons which are used in display operations. These 
pushbuttons are unmarked since their function is determined by software 
and may vary according to the particular program (system or user) which 
is in control of the system. 
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APPENDIX B 

USE OF VP15A DISPLAY DEVICE 


In XVM/DOS systems which have a VP15A Storage Tube Display, the PIP 
user may use the display device as a listing device. Be may list 
system and device directories and files in the following manner: 

a) Listing Directories - System and device directories may be 
displayed on the VP15A by specifying the display's device 
mnemonic (VP) as the destination device in an L, List, com- 
mand. For example, to cause the current UFD to be displayed 
in its most complete version, the user would issue the com- 
mand : 

>L l _iVP«-DK,_,(P)*' y 

b) Listing Files - The contents of files may be displayed on the 
VP by specifying it as the destination device in a T, Transfer, 
command. For example, to display the file TEST1 001 on the 
VP, the user would issue the command: 

>Tu_|VP-*-DKt_,TESTl 001-^ 

DISPLAY CONTROLS 


The VP15A display unit is provided with two pushbutton controls, ERASE 
and VIEW which are located on the right front panel of the CRT en- 
closure. These controls are used in the following manner: 

a) ERASE When operated, it causes the current display to be 

erased from the display. 

b) VIEW The normal brightness of displayed data fades after 

90 seconds unless renewed; this control enables the 
user to renew (brighten) the display when desired. 


WARNING 

The same display should not be maintained on the CRT 
for a period exceeding 15 minutes; if this occurs, 
the phosphor of the display CRT may be damaged. 
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Use of VP15A Display Device 


DISPLAY MODES 

The VP15A CRT is capable of displaying fifty-six 72-character lines. 

If the data file to be displayed exceeds the 56-line display capacity, 
the display will operate in either a SCAN or PAGE mode depending on 
the type of handler installed in the system (VPA or VPA.S) for the 
VP15A 1 . 

SCAN Mode 

When the VPA device handler is installed in the operating system, the 
VP15A display operates in a SCAN mode. In this mode, each time the 
display screen is filled it is erased, automatically, after the 56th 
list is written and is refilled from the display file. This fill-erase- 
rewrite cycle is continued until the screen is completely or partially 
filled and no more data is in the file to be displayed. The last dis- 
play is not erased but remains and may be renewed (brightened) manually 
by the viewer when necessary. 

PAGE Mode 

When the VPA.S version of the handler is installed in the operating 
system, the VP15A Display operates in a PAGE mode. In this mode 
the erase-rewrite operations of the display are controlled by the 
manual operation of the Accumulator zero switch (ACSj?) . Each time 
the display is filled, the full screen (i.e., page) is not erased 
and rewritten with the next set of available display file data if 
the ACS0 switch is actuated. This feature permits the user to 
manually advance through a file page-by-page. 


^The type of VP15A handler available in the operating system will be 
that selected by the System Manager during the configuration of the 
system. 
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APPENDIX C 


xvm/dos terms and acronyms 


Terms unique to the XVM/DOS Software System which are used in the PIP 
manual are listed and described in the following table. The acronyms 
for each term are also given. Detailed descriptions of the items iden- 
tified by the following terms are given in the XVM/DOS Users Manual. 


TERM ACRONYM DEFINITION 

Bad Allocation Table BAT A device (disk) table which in- 

dicates, in storage blocks, any 
faulty disk areas in which data 
cannot be stored. 

Master File Director MFD A master device (disk) file di- 

rectory which contains pointers 
to all user directories (UFD's) 
within a disk device. 

Monitor Identification Code MIC The master system password which 

permits full access to all files 
within the system. This code 
identifies the system manager 
and should be used only by him. 

Storage Allocation Table SAT The device (disk) table which 

stores busy, not-busy indicators 
for the disk storage area. 

System Block SYSBLK The system table which contains 

the names, locations, and load- 
ing and starting parameters for 
all system programs within the 
operating system. 

User File Directory UFD File directories for each user 

who establishes disk file stor- 
age areas within the system. 

User File Directory Table UFDT The system directory table which 

' maintains the relationship be- 

tween the system's .DAT slots 
and each unique user identifi- 
cation code (UIC ) . 
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XVM/DOS Terms and Acronyms 


TERM ACRONYM DEFINITION 

User Identification Code UIC A password entered by a user to 

uniquely define himself and any 
files which he may enter. If 
necessary, a user may enter more 
than one UIC to establish sev- 
eral unique sets of files. Since 
only one user may employ the sys- 
tem at any one time, the current 
UIC is the last logged-in UIC. 
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INDEX 


Abort operation, 1-2 
Acronyms, C-l 
Adding files, 3-40 
ALT mode, 1-3 
At symbol (@) usage, 1-3 


Back arrow (-«-) delimiter, 2-2 
Backslash ( \ ) usage, 1-3 
Bad Allocation Table (BAT) 
update, 3-43 
Bank mode, 4-1 
Block copy operation, 3-37 


Card input, 3-25 
Change filename, 3-34 
Character deletion, 1-3 
Characters, keyboard command, 

1- 3 

Checksum errors, 3-20, 3-27, 5-2 
Combining files during transfers, 
3-23 

Commands, destination/source, 

2 - 2 

Command string 

description, 2-1 
elements, 2-6 
errors, 5-1 
format, 2-4 
Command types 

destination /source, 2-2 
single-device, 2-3 
Continuation lines, 2-1 
Control characters, 1-3 
Copy mass storage, 3-39 
Create current UFD , 3-1 
CRT display, B-l 
CTRL C (+C) , 1-2 
CTRL keys, 1-3 
CTRL P (tP) , 1-2 
CTRL Q area ( iQAREA) , 3-5 
CTRL X, A- 1 


Data modes, 2-1, 2-11, 2-12, 

2-13 

Data mode specifications, 3-14 
Data transfer, 2-2 

see also File transfers 
DECtape directories, 

initialization of, 3-4 
listing of, 3-10 


Delete operation, 3-31 
Deletion of 

characters, 1-3 
DECtape files, 3-34 
files from UFDs, 3-32 
lines, 1-3 

trailing spaces, 3-26 
truncated files, 3-34, 4-2 
UFDs, 3-3 
Delimiters, 2-6 

Destination/source commands, 2-2 
Devices, 2-1, 2-7 
Device to device file transfers, 

3-17 

Directoried devices, file trans- 
fers between, 3-13 
Directory initialization, 3-41 
Directory initialization during 
transfer, 3-22 

Directory list operation, 3-5 
Directory protection codes, 3-36 
Directory setup, 3-1 
Display device, VP15A, B-l 
Display system, VT15 graphics, A-l 
Dump mode, 2-12, 3-41 


ERASE pushbutton, B-l 
Error corrections, 5-7 
Error detection, 5-1 
Error messages, 

PIP, 5-3 
system, D-l 


Filename, 2-1, 2-3 
extensions, 2-13 

File protection codes, 2-13, 2-14, 
3-14, 3-36 

Files, deletion of, 3-34 
File transfer commands, 3-12 
File transfers, 
card input, 3-25 
device to device, 3-17 
to disk, 3-15 

keyboard input to output device , 
3-18 

paper tape input, 3-25 
source file to multiple paper 
tapes, 3-31 
UFD to UFD, 3-16 
Functions, optional, 2-9 
Function switches, 3-20 
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INDEX 


Horizontal tab codes, 3-21 


Image alphanumeric data mode, 
2-12 

Image binary data mode, 2-12 
Initialization of 
current UFD , 3-1 
DECtape directories, 3-4 
MFD, 4-2 

new directory, 3-1 
Input/output devices, 2-7 
Input, termination of, 1-3 
IOPS ASCII data mode, 2-11 
IOPS binary data mode, 2-11 


Keyboard command characters, 1-3 


Line deletion, 1-3 
List DECtape directories, 3-10 
List directory operation, 4-2 
List (L) operation, 3-5 
List MFD, 3-7 
List monitor SYSBLK , 3-8 
List selected file, 3-10 
List UFD, 3-6 

List UFD with file protection 
codes, 3-9 


Master File Directory (MFD) 
listing, 3-7 
Mnemonics, 2-7 
Monitor Identification Code 
(MIC) , 4-1 


New directory (N) operation, 3-1 


Operation, abort, 1-2 
Operational errors, 5-2 
Optional functions, 2-1, 2-9 
Options, 6-3 
Option switches, 2-3 
Output to paper tape, 3-31 


Page mode, 4-1 
VP15A, B-2 
VT15, A- 2 


Paper tape input, 3-25 
Parity/checksum error correction, 
3-20 

Parity errors, 3-27, 5-2 
Primary operations, 2-7 
summary of, 2-8 

Protection codes, 2-1, 2-14, 3-2, 
3-36 

violations of, 5-2 
Pushbuttons, 

VP15A , B-l 
VT15, A-2 


Q-dump operations, 3-5 


Renaming files, 3-35 
Restart PIP, 1-3 
RETURN, 1-3 


SCAN mode, VP15A, B-2 
SCROLL mode, VT15, A-2 
Segmentation point, 3-28 
Segment file operation, 3-28 
Selected file, listing of, 3-10 
Single-device commands, 2-3 
Single file transfers, 3-13 
Source file to multiple paper 

tapes segmentation operations, 
3-31 

Space, delete trailing, 3-26 
Space delimiters, 3-21 
Space-to-tab conversion, 3-21 
Startup procedures, 1-2 
Storage Allocation Table (SAT) 
update, 3-42 
Storage device, 2-7 
Switch combinations, 3-14, 3-20 
Switches, data 

(A) , 2-11 

(B) , 2-11 

(D) , 2-12 

(H) , 2-12 

(I) , 2-12 

Switches, function 

(C) , 3-21, 3-22, 3-25, 3-26 

(E) , 3-21 
(G) , 3-20 

(K) , 3-4 

(L) , 3-6, 3-8, 3-10 

(M) , 3-6, 3-7, 3-10 

(N) , 3-22, 3-41 

(P) , 3-6, 3-9, 3-10, 3-12 

(Q) , 3-25 
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INDEX 


Switches, function 

(S) , 3-5, 3-41 

(T) , 3-25 

(V) , 3-25 

(W) , 3-23, 3-25 
Symbols in text, 1-3 
SYSBLK listing, 3-8 
System error messages, D-l 
System file protection code, 

3-14 


Tab delimiters, 3-21 
Tables, 6-1 

Tab-to-space conversion, 3-21 
Terminate input, 1-3 
Terms, XVM/DOS, C-l 
Trailing spaces, deletion of, 
3-26 

Transfer files 

see File transfers 
Truncated files, 3-35, 3-40 


UFD to UFD file transfers, 3-16 


UIC block copy, 3-38 
Updating tables, 3-42 
User File Directory (UFD) , 2- 
2-13 

deletion, 3-3 
file deletion, 3-32 
initialization, 4-1 
listing, 3-6, 3-9 
protection code, 3-2 


Verify operation, 3-27 
Vertical forms control, 3-26 
VIEW pushbutton, B-l 
VP15A display device, B-l 
VT15 graphics display system, 
A-l 


Writing conventions, 1-2 


XVM/DOS terms, C-l 
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READER'S COMMENTS 


NOTE: This form is for document comments only. Problems 

with software should be reported on a Software 
Problem Report (SPR) form. 


you find errors in this manual? If so, specify by page 


Did you find this manual understandable, usable, and well-organized? 
Please make suggestions for improvement. 


Is there sufficient documentation on associated system programs 
required for use of the software described in this manual? If not, 
what material is missing and where should it be placed? 


Please indicate the type of user/reader that you most nearly represent. 

| | Assembly language programmer 
| | Higher-level language programmer 
| Occasional programmer (experienced) 

| | User with little programming experience 
| | Student programmer 

Non-programmer interested in computer concepts and capabilities 

Name - Date 

Organization 

Street — 

City — State Zip Code 

or 

Country 

If you require a written reply, please check here. □ 
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